PHFetchOptions

PHFetchOptions

A set of options that affect the filtering, sorting, and management of results that Photos returns when you fetch asset or collection objects.

SDKs

• iOS 8.0+
• macOS 10.13+
• tvOS 10.0+

Framework

• Photos

On This Page

• Overview
• Topics
• Relationships
• See Also

Overview

Using class methods on the PHAsset, PHCollection, PHAssetCollection, and PHCollectionList classes to fetch assets or collections produces a PHFetchResultobject containing the requested objects. The options you specify control which objects the fetch result includes, how those objects are arranged in the fetch result, and how Photos should notify your app of changes to the fetch result.

Photos supports only a restricted set of keys for the predicate and sortDescriptorsproperties. The set of available keys depends on which class you’re using to fetch assets or collections—see Table 1 for the list of keys supported by each class.

Table 1 

Supported predicate and sort descriptor keys

Class for Fetch Method	Supported Keys
PHAsset	SELF, localIdentifier, creationDate, modificationDate, mediaType, mediaSubtypes, duration, pixelWidth, pixelHeight, favorite (or isFavorite), hidden(or isHidden), burstIdentifier
PHAssetCollection	SELF, localIdentifier, localizedTitle (or title), startDate, endDate, estimatedAssetCount
PHCollectionList	SELF, localIdentifier, localizedTitle (or title), startDate, endDate
PHCollection (can fetch a mix of PHCollectionList and PHAssetCollectionobjects)	SELF, localIdentifier, localizedTitle (or title), startDate, endDate