---
title: PHFetchOptions
framework: photos
role: symbol
role_heading: Class
path: photos/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.

## Declaration

```swift
class PHFetchOptions
```

## Mentioned in

Fetching Assets

## Overview

Overview Using class methods on the PHAsset, PHCollection, PHAssetCollection, and PHCollectionList classes to fetch assets or collections produces a PHFetchResult object 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 sortDescriptors properties. The set of available keys depends on which class you’re using to fetch assets or collections. The following table lists the keys supported by each class:  |   |   |   |   |

## Topics

### Sorting and Filtering Fetch Results

- [predicate](photos/phfetchoptions/predicate.md)
- [sortDescriptors](photos/phfetchoptions/sortdescriptors.md)

### Subscribing to Changes

- [wantsIncrementalChangeDetails](photos/phfetchoptions/wantsincrementalchangedetails.md)

### Limiting Fetch Results

- [fetchLimit](photos/phfetchoptions/fetchlimit.md)
- [includeAllBurstAssets](photos/phfetchoptions/includeallburstassets.md)
- [includeHiddenAssets](photos/phfetchoptions/includehiddenassets.md)
- [includeAssetSourceTypes](photos/phfetchoptions/includeassetsourcetypes.md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCopying](foundation/nscopying.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)

## See Also

### Asset retrieval

- [Fetching Objects and Requesting Changes](photokit/fetching-objects-and-requesting-changes.md)
- [PHAsset](photos/phasset.md)
- [PHAssetCollection](photos/phassetcollection.md)
- [PHCollection](photos/phcollection.md)
- [PHCollectionList](photos/phcollectionlist.md)
- [PHObject](photos/phobject.md)
- [PHFetchResult](photos/phfetchresult.md)