<!--
{
  "availability" : [
    "macOS: 10.6.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "QuickLookUI",
  "identifier" : "/documentation/QuickLookUI/QLPreviewItem/previewItemDisplayState",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "Quick Look UI"
    ],
    "preciseIdentifier" : "c:objc(pl)QLPreviewItem(py)previewItemDisplayState"
  },
  "title" : "previewItemDisplayState"
}
-->

# previewItemDisplayState

The display state for the preview item.

```
optional var previewItemDisplayState: Any! { get }
```

## Discussion

The display state is an opaque object used by the preview panel. You typically use the [`QLPreviewPanel`](/documentation/QuickLookUI/QLPreviewPanel) method [`displayState`](/documentation/QuickLookUI/QLPreviewPanel/displayState) to retrieve the display state which you save for later use in the preview item. This way you can preserve the display state when the panel moves from or to another controller.

This property is optional.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)