---
title: preferredResolution
framework: AVFoundation
role: symbol
role_heading: Instance Property
platforms: [iOS 26.0+, iPadOS 26.0+, Mac Catalyst 26.0+, macOS 26.0+, tvOS 26.0+]
path: avfoundation/avcaptureexternaldisplayconfiguration/preferredresolution
---

# preferredResolution

Your preferred external display resolution.

## Declaration

```swift
var preferredResolution: CMVideoDimensions { get set }
```

## Discussion

Discussion Use preferredResolution to set your desired resolution of the external display. When left at the default value of { 0, 0 },  the native resolution of the external display is used.

## See Also

### Modifying the configuration

- [bypassColorSpaceConversion](avfoundation/avcaptureexternaldisplayconfiguration/bypasscolorspaceconversion.md)
- [shouldMatchFrameRate](avfoundation/avcaptureexternaldisplayconfiguration/shouldmatchframerate.md)