Generate thumbnails for common file types and add a Thumbnail Extension to your app to enable others to create thumbnails of your custom files.
- iOS 13.0+
- macOS 10.15+
- Mac Catalyst 13.0+
You may want to create a miniature representation, or thumbnail, of a file and its contents to display within your app. The QuickLookThumbnailing framework provides an API to generate thumbnails using the
QLThumbnail object. It can generate thumbnails for common file types, including:
Audio and video files
Augmented reality objects using the
USDZfile format (iOS and iPadOS only)
Many apps use custom file types to persist their data. Finder and Spotlight on macOS, other features of the operating system, as well as other apps, often display a generic file icon instead of a thumbnail for these files. However, if an installed app implements a Thumbnail Extension that supports the custom file types, the operating system and other apps can leverage the extension to display rich thumbnails of the custom file types through the
QLThumbnail object. Add a Thumbnail Extension to your app to provide rich thumbnails of your custom file types to your users throughout the operating system and third party apps.