---
title: "previewDisplayName(_:)"
framework: swiftui
role: symbol
role_heading: Instance Method
path: "swiftui/view/previewdisplayname(_:)"
---

# previewDisplayName(_:)

Sets a user visible name to show in the canvas for a preview.

## Declaration

```swift
nonisolated func previewDisplayName(_ value: String?) -> some View

```

## Parameters

- `value`: A name for the preview.

## Return Value

Return Value A preview that uses the given name.

## Discussion

Discussion Apply this modifier to a view inside your PreviewProvider implementation to associate a display name with that view’s preview: struct CircleImage_Previews: PreviewProvider {     static var previews: some View {         CircleImage()             .previewDisplayName("Circle")     } }

Add a name when you have multiple previews together in the canvas that you need to tell apart. The default value is nil, in which case Xcode displays a default string.

## See Also

### Defining a preview

- [Previewable()](swiftui/previewable().md)
- [PreviewProvider](swiftui/previewprovider.md)
- [PreviewPlatform](swiftui/previewplatform.md)
- [PreviewModifier](swiftui/previewmodifier.md)
- [PreviewModifierContent](swiftui/previewmodifiercontent.md)