---
title: "creationRequestForCollectionList(withTitle:)"
framework: photos
role: symbol
role_heading: Type Method
path: "photos/phcollectionlistchangerequest/creationrequestforcollectionlist(withtitle:)"
---

# creationRequestForCollectionList(withTitle:)

Creates a request for adding a new collection list to the Photos library.

## Declaration

```swift
class func creationRequestForCollectionList(withTitle title: String) -> Self
```

## Parameters

- `title`: A name for the new collection list.

## Return Value

Return Value A collection list creation request.

## Discussion

Discussion Call this method within a photo library change block to create a new collection list. For details on change blocks, see PHPhotoLibrary. To add collections to the newly created collection list or to change its title, use the methods listed in Managing Collections. To reference the newly created collection list later in the same change block or after the change block completes, use the placeholderForCreatedCollectionList property to retrieve a placeholder object.

## See Also

### Managing Collection Lists

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