---
title: "selectItem(at:animated:scrollPosition:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uicollectionview/selectitem(at:animated:scrollposition:)"
---

# selectItem(at:animated:scrollPosition:)

Selects the item at the specified index path and optionally scrolls it into view.

## Declaration

```swift
func selectItem(at indexPath: IndexPath?, animated: Bool, scrollPosition: UICollectionView.ScrollPosition)
```

## Parameters

- `indexPath`: The index path of the item to select. Specifying nil for this parameter clears the current selection.
- `animated`: Specify doc://com.apple.documentation/documentation/Swift/true to animate the change in the selection or doc://com.apple.documentation/documentation/Swift/false to make the change without animating it.
- `scrollPosition`: An option that specifies where the item should be positioned when scrolling finishes. For a list of possible values, see doc://com.apple.uikit/documentation/UIKit/UICollectionView/ScrollPosition.

## Discussion

Discussion If the allowsSelection property is false, calling this method has no effect. If there’s an existing selection with a different index path and the allowsMultipleSelection property is false, calling this method replaces the previous selection. This method doesn’t cause any selection-related delegate methods to be called.

## See Also

### Selecting cells

- [indexPathsForSelectedItems](uikit/uicollectionview/indexpathsforselecteditems.md)
- [deselectItem(at:animated:)](uikit/uicollectionview/deselectitem(at:animated:).md)
- [allowsSelection](uikit/uicollectionview/allowsselection.md)
- [allowsMultipleSelection](uikit/uicollectionview/allowsmultipleselection.md)
- [allowsSelectionDuringEditing](uikit/uicollectionview/allowsselectionduringediting.md)
- [allowsMultipleSelectionDuringEditing](uikit/uicollectionview/allowsmultipleselectionduringediting.md)
- [selectionFollowsFocus](uikit/uicollectionview/selectionfollowsfocus.md)