---
title: Preview macros
framework: widgetkit
role: collectionGroup
role_heading: API Collection
path: widgetkit/preview-macros
---

# Preview macros

Use Swift macros to create widget previews in Xcode.

## Topics

### Generating a widget preview

- [Preview(_:as:widget:timelineProvider:)](widgetkit/preview(_:as:widget:timelineprovider:).md)
- [Preview(_:as:using:widget:timelineProvider:)](widgetkit/preview(_:as:using:widget:timelineprovider:)-4ljg1.md)
- [Preview(_:as:using:widget:timelineProvider:)](widgetkit/preview(_:as:using:widget:timelineprovider:)-3df1l.md)
- [Preview(_:as:widget:timeline:)](widgetkit/preview(_:as:widget:timeline:).md)
- [Preview(_:widget:relevanceEntries:)](widgetkit/preview(_:widget:relevanceentries:).md)
- [Preview(_:widget:relevanceProvider:)](widgetkit/preview(_:widget:relevanceprovider:).md)
- [Preview(_:widget:relevanceProvider:relevance:)](widgetkit/preview(_:widget:relevanceprovider:relevance:).md)

### Generating a Live Activity preview

- [Preview(_:as:using:widget:contentStates:)](widgetkit/preview(_:as:using:widget:contentstates:).md)

### Generated structures

- [PreviewActivityBuilder](widgetkit/previewactivitybuilder.md)
- [PreviewRelevanceEntryBuilder](widgetkit/previewrelevanceentrybuilder.md)
- [PreviewTimelineBuilder](widgetkit/previewtimelinebuilder.md)

## See Also

### Previews and debugging

- [Previewing widgets and Live Activities in Xcode](widgetkit/previewing-widgets-and-live-activities-in-xcode.md)
- [WidgetPreviewContext](widgetkit/widgetpreviewcontext.md)