---
title: previewItemURL
framework: quicklookui
role: symbol
role_heading: Instance Property
path: quicklookui/qlpreviewitem/previewitemurl
---

# previewItemURL

The URL of the item to preview.

## Declaration

```swift
var previewItemURL: URL! { get }
```

## Discussion

Discussion QLPreviewController uses this property to get an item’s URL. In typical use, you’d implement a getter method in your preview item class to provide this value. The value of this property must be a file-type URL. If the item isn’t available for preview, this property’s getter method should return nil. In this case, the QLPreviewController displays a “loading” view. Use refreshCurrentPreviewItem() to reload the item once the URL content is available.

## See Also

### Instance Properties

- [previewItemDisplayState](quicklookui/qlpreviewitem/previewitemdisplaystate.md)
- [previewItemTitle](quicklookui/qlpreviewitem/previewitemtitle.md)