# UICollectionViewListCell A collection view cell that provides list features and default styling. ``` @MainActor class UICollectionViewListCell ``` ## Overview A list cell represents an individual item that might appear in a list. List cells provide built-in support for indentation, and the ability to add cell accessories ([`UICellAccessory`](/documentation/UIKit/UICellAccessory-swift.struct)) for visual adornment or to support user interactions with the cell. You can use a list cell in any type of layout. Using a list cell inside a list enables additional list-specific behavior for the cells. For example, in a list section or layout, you can define separator alignment between list cells, and configure swipe actions for each cell’s leading and trailing edges. You create an individual list section using [`list(using:layoutEnvironment:)`](/documentation/UIKit/NSCollectionLayoutSection/list(using:layoutEnvironment:)), or a full list layout using [`list(using:)`](/documentation/UIKit/UICollectionViewCompositionalLayout/list(using:)). You can use a list cell’s [`defaultContentConfiguration()`](/documentation/UIKit/UICollectionViewListCell/defaultContentConfiguration()) (Swift) or [`defaultContentConfiguration`](/documentation/UIKit/UICollectionViewListCell/defaultContentConfiguration) (Objective-C) to get a list content configuration that has preconfigured default styling. After you get the default configuration, you assign your content to it, customize any other properties, and assign it to the cell as the current content configuration. For customization options, see [`UIListContentConfiguration`](/documentation/UIKit/UIListContentConfiguration-swift.struct). ```objc UIListContentConfiguration *content = [cell defaultContentConfiguration]; // Configure content. [content setImage:[UIImage systemImageNamed:@"star"]]; [content setText:@"Favorites"]; // Customize appearance. [content.imageProperties setTintColor:[UIColor purpleColor]]; [cell setContentConfiguration:content]; ``` Alternatively, you can set your content through your own custom subviews using the cell’s [`contentView`](/documentation/UIKit/UICollectionViewCell/contentView). ## Topics ### Getting a configuration [`defaultContentConfiguration()`](/documentation/UIKit/UICollectionViewListCell/defaultContentConfiguration()) Retrieves a default list content configuration for the cell’s style. [`defaultContentConfiguration`](/documentation/UIKit/UICollectionViewListCell/defaultContentConfiguration) Retrieves a default list content configuration for the cell’s style. ### Managing cell accessories [`accessories`](/documentation/UIKit/UICollectionViewListCell/accessories-8nui4) An array of the accessories that decorate the cell. [`accessories`](/documentation/UIKit/UICollectionViewListCell/accessories-88j0f) An array of the accessories that decorate the cell. [`UICellAccessory`](/documentation/UIKit/UICellAccessory-swift.struct) An accessory in a collection view list cell. [`UICellAccessory`](/documentation/UIKit/UICellAccessory-c.class) An accessory in a collection view list cell. ### Customizing layout [`indentationLevel`](/documentation/UIKit/UICollectionViewListCell/indentationLevel) The level of indentation for the cell. [`indentationWidth`](/documentation/UIKit/UICollectionViewListCell/indentationWidth) The width of an indentation level. [`indentsAccessories`](/documentation/UIKit/UICollectionViewListCell/indentsAccessories) A Boolean value that detemines whether the cell indents accessories on the leading side. [`separatorLayoutGuide`](/documentation/UIKit/UICollectionViewListCell/separatorLayoutGuide) A guide for laying out separators in relation to the primary content in the cell. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)