---
title: "setCollectionViewLayout(_:animated:completion:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uicollectionview/setcollectionviewlayout(_:animated:completion:)"
---

# setCollectionViewLayout(_:animated:completion:)

Changes the collection view’s layout and notifies you when the animations complete.

## Declaration

```swift
func setCollectionViewLayout(_ layout: UICollectionViewLayout, animated: Bool, completion: ((Bool) -> Void)? = nil)
```

## Parameters

- `layout`: The new layout object for the collection view.
- `animated`: Specify doc://com.apple.documentation/documentation/Swift/true if you want to animate changes from the current layout to the new layout specified by the layout parameter. Specify doc://com.apple.documentation/documentation/Swift/false to make the change without animations.
- `completion`: The block that’s executed when the layout transition finishes or is terminated by the user. This block takes the following parameter:

## Discussion

Discussion This method initiates a layout change programmatically, notifying you when the transition is complete. If you choose to animate the layout change, the animation timing and parameters are controlled by the collection view.

## See Also

### Changing the layout

- [collectionViewLayout](uikit/uicollectionview/collectionviewlayout.md)
- [setCollectionViewLayout(_:animated:)](uikit/uicollectionview/setcollectionviewlayout(_:animated:).md)
- [startInteractiveTransition(to:completion:)](uikit/uicollectionview/startinteractivetransition(to:completion:).md)
- [finishInteractiveTransition()](uikit/uicollectionview/finishinteractivetransition().md)
- [cancelInteractiveTransition()](uikit/uicollectionview/cancelinteractivetransition().md)
- [UICollectionView.LayoutInteractiveTransitionCompletion](uikit/uicollectionview/layoutinteractivetransitioncompletion.md)