<!--
{
  "availability" : [
    "iOS: 10.0.0 -",
    "iPadOS: 10.0.0 -",
    "macCatalyst: 14.0.0 -",
    "tvOS: 17.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVFoundation",
  "identifier" : "/documentation/AVFoundation/AVCapturePhotoSettings/previewPhotoFormat",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "AVFoundation"
    ],
    "preciseIdentifier" : "c:objc(cs)AVCapturePhotoSettings(py)previewPhotoFormat"
  },
  "title" : "previewPhotoFormat"
}
-->

# previewPhotoFormat

A dictionary describing the format for delivery of preview-sized images alongside the main photo.

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

## Discussion

By default, this property is `nil`, specifying that the photo output should return only the main image requested. To also receive a preview-sized image, set this property to a dictionary describing the format for that image, containing the following keys and values:

The dictionary must contain the <doc://com.apple.documentation/documentation/CoreVideo/kCVPixelBufferPixelFormatTypeKey> key, whose corresponding value must be one of the pixel format types listed in the [`availablePreviewPhotoPixelFormatTypes`](/documentation/AVFoundation/AVCapturePhotoSettings/availablePreviewPhotoPixelFormatTypes-2vfwu) array.

Optionally, you can also include the <doc://com.apple.documentation/documentation/CoreVideo/kCVPixelBufferWidthKey> and <doc://com.apple.documentation/documentation/CoreVideo/kCVPixelBufferHeightKey> keys to specify the size of the preview 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 preview 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.

---

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)