---
title: "QLThumbnailCreate(_:_:_:_:)"
framework: quicklook
role: symbol
role_heading: Function
path: "quicklook/qlthumbnailcreate(_:_:_:_:)"
---

# QLThumbnailCreate(_:_:_:_:)

Returns a thumbnail that’s generated in the background.

## Declaration

```swift
func QLThumbnailCreate(_ allocator: CFAllocator!, _ url: CFURL!, _ maxThumbnailSize: CGSize, _ options: CFDictionary!) -> Unmanaged<QLThumbnail>!
```

## Parameters

- `allocator`: The allocator to use to create the thumbnail.
- `url`: The URL of the document that you want to request a thumbnail for.
- `maxThumbnailSize`: The maximum size in points for the thumbnail image.
- `options`: Optional hints for creating a thumbnail image. Available options are doc://com.apple.quicklook/documentation/QuickLook/kQLThumbnailOptionScaleFactorKey and doc://com.apple.quicklook/documentation/QuickLook/kQLThumbnailOptionIconModeKey.

## Return Value

Return Value A generated thumbnail of the file at the provided url.

## See Also

### Creating thumbnails

- [QLThumbnailImageCreate(_:_:_:_:)](quicklook/qlthumbnailimagecreate(_:_:_:_:).md)
- [QLThumbnailDispatchAsync(_:_:_:)](quicklook/qlthumbnaildispatchasync(_:_:_:).md)
- [QLThumbnailCancel(_:)](quicklook/qlthumbnailcancel(_:).md)
- [QLThumbnailCopyDocumentURL(_:)](quicklook/qlthumbnailcopydocumenturl(_:).md)
- [QLThumbnailCopyImage(_:)](quicklook/qlthumbnailcopyimage(_:).md)
- [QLThumbnailCopyOptions(_:)](quicklook/qlthumbnailcopyoptions(_:).md)
- [QLThumbnailGetContentRect(_:)](quicklook/qlthumbnailgetcontentrect(_:).md)
- [QLThumbnailGetMaximumSize(_:)](quicklook/qlthumbnailgetmaximumsize(_:).md)
- [QLThumbnailGetTypeID()](quicklook/qlthumbnailgettypeid().md)
- [QLThumbnailIsCancelled(_:)](quicklook/qlthumbnailiscancelled(_:).md)