---
title: embeddedThumbnailPhotoFormat
framework: avfoundation
role: symbol
role_heading: Instance Property
path: avfoundation/avcapturephotosettings/embeddedthumbnailphotoformat
---

# embeddedThumbnailPhotoFormat

A dictionary describing the format for delivery of thumbnail images embedded in photo file output.

## Declaration

```swift
var embeddedThumbnailPhotoFormat: [String : Any]? { get set }
```

## Mentioned in

Capturing thumbnail and preview images

## Discussion

Discussion By default, this property is nil, specifying that the photo output should not embed thumbnail images in photo file output. To enable embedding, set this property to a dictionary describing the format for thumbnail images, containing the following keys and values: The dictionary must contain the key AVVideoCodecKey, whose corresponding value must be one of the pixel format types listed in the availableEmbeddedThumbnailPhotoCodecTypes array. Optionally, you can also include the AVVideoWidthKey and AVVideoHeightKey keys to specify the size of the thumbnail image. (If you specify either width or height, you must specify both.) If the size you specify does not match the aspect ratio of the primary photo, the photo output provides a thumbnail image whose size matches the longer of the two specified dimensions, preserving the original aspect ratio. note: The photo capture system supports both preview and thumbnail images as companions to the full-size primary image in a photo capture. A preview image is intended for immediate display (as seen when taking photos in the iOS Camera app), and as such is sized for full-screen presentation on the current device. A thumbnail image is intended for embedding in the output image file and can be used by other software (such as Quick Look in a file browser) to allow users to quickly review the image without loading the entire image file; the size of thumbnail images may be limited depending on the output file format.

## See Also

### Enabling preview and thumbnail delivery

- [previewPhotoFormat](avfoundation/avcapturephotosettings/previewphotoformat.md)
- [availablePreviewPhotoPixelFormatTypes](avfoundation/avcapturephotosettings/availablepreviewphotopixelformattypes-30d9.md)
- [availableRawEmbeddedThumbnailPhotoCodecTypes](avfoundation/avcapturephotosettings/availablerawembeddedthumbnailphotocodectypes.md)
- [rawEmbeddedThumbnailPhotoFormat](avfoundation/avcapturephotosettings/rawembeddedthumbnailphotoformat.md)
- [availableEmbeddedThumbnailPhotoCodecTypes](avfoundation/avcapturephotosettings/availableembeddedthumbnailphotocodectypes.md)