---
title: PHCollectionListChangeRequest
framework: photos
role: symbol
role_heading: Class
path: photos/phcollectionlistchangerequest
---

# PHCollectionListChangeRequest

A request to create, delete, or modify a Photos collection list, for use in a photo library change block.

## Declaration

```swift
class PHCollectionListChangeRequest
```

## Mentioned in

Requesting Changes to the Photo Library

## Overview

Overview You use the PHCollectionListChangeRequest class to request changes for PHCollectionList objects. To make changes to collection lists (such as folders containing user-created albums) in the Photos library, create a change request using the appropriate class method for the change you want to perform. Call the creationRequestForCollectionList(withTitle:) method to create a new asset collection. Call the deleteCollectionLists(_:) method to delete existing asset collections. Call the init(for:) or init(for:childCollections:) method to modify a collection’s metadata or its list of child collections. Before creating a change request, use the canPerform(_:) method to verify that the collection allows the edit operation you’re requesting. If you attempt to perform an unsupported edit operation, Photos throws an exception. A change request for creating or modifying a collection list works like a mutable version of the collection list object. Use the change request’s properties and instance methods to request changes to the collection list itself. For example, the following code removes an album from a folder. After Photos runs the change block and calls your completion handler, the collection list’s state reflects the changes you requested in the block. If you create or use a change request object outside a photo library change block, Photos raises an Objective-C exception. For details on change blocks, see PHPhotoLibrary.

## Topics

### Creating a Change Request

- [init(for:)](photos/phcollectionlistchangerequest/init(for:).md)
- [init(for:childCollections:)](photos/phcollectionlistchangerequest/init(for:childcollections:).md)
- [init(forTopLevelCollectionListUserCollections:)](photos/phcollectionlistchangerequest/init(fortoplevelcollectionlistusercollections:).md)

### Managing Collection Lists

- [creationRequestForCollectionList(withTitle:)](photos/phcollectionlistchangerequest/creationrequestforcollectionlist(withtitle:).md)
- [placeholderForCreatedCollectionList](photos/phcollectionlistchangerequest/placeholderforcreatedcollectionlist.md)
- [deleteCollectionLists(_:)](photos/phcollectionlistchangerequest/deletecollectionlists(_:).md)

### Managing Collections

- [addChildCollections(_:)](photos/phcollectionlistchangerequest/addchildcollections(_:).md)
- [insertChildCollections(_:at:)](photos/phcollectionlistchangerequest/insertchildcollections(_:at:).md)
- [moveChildCollections(at:to:)](photos/phcollectionlistchangerequest/movechildcollections(at:to:).md)
- [replaceChildCollections(at:withChildCollections:)](photos/phcollectionlistchangerequest/replacechildcollections(at:withchildcollections:).md)
- [removeChildCollections(_:)](photos/phcollectionlistchangerequest/removechildcollections(_:).md)
- [removeChildCollections(at:)](photos/phcollectionlistchangerequest/removechildcollections(at:).md)

### Inspecting the Request

- [title](photos/phcollectionlistchangerequest/title.md)

### Initializers

- [init(forCollectionList:)](photos/phcollectionlistchangerequest/init(forcollectionlist:).md)
- [init(forCollectionList:childCollections:)](photos/phcollectionlistchangerequest/init(forcollectionlist:childcollections:).md)

## Relationships

### Inherits From

- [PHChangeRequest](photos/phchangerequest.md)

### Conforms To

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

## See Also

### Updating the Library

- [Requesting Changes to the Photo Library](photokit/requesting-changes-to-the-photo-library.md)
- [performChanges(_:completionHandler:)](photos/phphotolibrary/performchanges(_:completionhandler:).md)
- [performChangesAndWait(_:)](photos/phphotolibrary/performchangesandwait(_:).md)
- [PHChangeRequest](photos/phchangerequest.md)
- [PHAssetChangeRequest](photos/phassetchangerequest.md)
- [PHAssetCollectionChangeRequest](photos/phassetcollectionchangerequest.md)
- [PHObjectPlaceholder](photos/phobjectplaceholder.md)