<!--
{
  "availability" : [
    "iOS: 14.0.0 -",
    "iPadOS: 14.0.0 -",
    "macCatalyst: -",
    "macOS: 13.0.0 -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "PhotoKit",
  "identifier" : "/documentation/PhotosUI/PHPickerConfiguration-swift.struct",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "PhotosUI"
    ],
    "preciseIdentifier" : "s:8PhotosUI21PHPickerConfigurationV"
  },
  "title" : "PHPickerConfiguration"
}
-->

# PHPickerConfiguration

An object that contains information about how to configure a picker view controller.

```
struct PHPickerConfiguration
```

## Topics

### Creating a configuration

[`init()`](/documentation/PhotosUI/PHPickerConfiguration-swift.struct/init())

Creates a new configuration object.

[`init(photoLibrary:)`](/documentation/PhotosUI/PHPickerConfiguration-swift.struct/init(photoLibrary:))

Creates a new configuration object for a photo library.

### Filtering asset types

[`filter`](/documentation/PhotosUI/PHPickerConfiguration-swift.struct/filter)

The filter you apply to restrict the asset types the picker displays.

[`PHPickerFilter`](/documentation/PhotosUI/PHPickerFilter-swift.struct)

A type that defines the filter to apply to the photo library.

### Selecting the preferred asset representation

[`preferredAssetRepresentationMode`](/documentation/PhotosUI/PHPickerConfiguration-swift.struct/preferredAssetRepresentationMode)

A mode that determines which representation to use if an asset contains more than one.

[`PHPickerConfiguration.AssetRepresentationMode`](/documentation/PhotosUI/PHPickerConfiguration-swift.struct/AssetRepresentationMode)

Constants identifying the mode the system uses when many representations exist for an asset.

### Preselecting assets

[`preselectedAssetIdentifiers`](/documentation/PhotosUI/PHPickerConfiguration-swift.struct/preselectedAssetIdentifiers)

An array of asset identifiers to preselect in the picker.

### Setting the selection limit

[`selectionLimit`](/documentation/PhotosUI/PHPickerConfiguration-swift.struct/selectionLimit)

The maximum number of selections the user can make.

[`selection`](/documentation/PhotosUI/PHPickerConfiguration-swift.struct/selection-swift.property)

The selection behavior for the picker.

[`PHPickerConfigurationSelection`](/documentation/PhotosUI/PHPickerConfigurationSelection)

Options that represent differing selection behavior.

[`PHPickerConfiguration.Selection`](/documentation/PhotosUI/PHPickerConfiguration-swift.struct/Selection-swift.enum)

Options that represent differing selection behavior.

### Customizing picker appearance and behavior

[`mode`](/documentation/PhotosUI/PHPickerConfiguration-swift.struct/mode)

A layout type for the photos in the picker’s view.

[`PHPickerMode`](/documentation/PhotosUI/PHPickerMode-swift.struct)

Layout options that determine how the picker orders photos visually.

[`disabledCapabilities`](/documentation/PhotosUI/PHPickerConfiguration-swift.struct/disabledCapabilities)

The aspects of a photo picker’s default appearance that your app can disable.

[`PHPickerCapabilities`](/documentation/PhotosUI/PHPickerCapabilities)

Options that customize the look and behavior of the photos picker.

[`edgesWithoutContentMargins`](/documentation/PhotosUI/PHPickerConfiguration-swift.struct/edgesWithoutContentMargins)

The portions of a photo picker’s perimeter that are borderless.

[`PHPickerConfiguration.Update`](/documentation/PhotosUI/PHPickerConfiguration-swift.struct/Update)

An object that defines the aspects of a photo picker’s appearance that can change while it’s presented.


---

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)