---
title: UICollectionLayoutListConfiguration
framework: uikit
role: symbol
role_heading: Structure
path: uikit/uicollectionlayoutlistconfiguration-swift.struct
---

# UICollectionLayoutListConfiguration

A configuration for creating a list layout.

## Declaration

```swift
struct UICollectionLayoutListConfiguration
```

## Overview

Overview Use this configuration to create a list section for a compositional layout (UICollectionViewCompositionalLayout), or a layout containing only list sections. The following example shows how to create a compositional layout that contains only list sections by applying the same configuration to each section in the list layout: let configuration = UICollectionLayoutListConfiguration(appearance: .sidebar) let layout = UICollectionViewCompositionalLayout.list(using: configuration) To implement different list configurations for different sections, use a compositional layout’s section provider to create each section with its own list configuration. let layout = UICollectionViewCompositionalLayout() { sectionIndex, layoutEnvironment in          var configuration = UICollectionLayoutListConfiguration(appearance: .insetGrouped)     configuration.headerMode = sectionIndex == 0 ? .supplementary : .none          let section = NSCollectionLayoutSection.list(using: configuration,                                                  layoutEnvironment: layoutEnvironment)          return section }

## Topics

### Creating a list layout configuration

- [init(appearance:)](uikit/uicollectionlayoutlistconfiguration-swift.struct/init(appearance:).md)

### Configuring appearance

- [appearance](uikit/uicollectionlayoutlistconfiguration-swift.struct/appearance-swift.property.md)
- [backgroundColor](uikit/uicollectionlayoutlistconfiguration-swift.struct/backgroundcolor.md)
- [UICollectionLayoutListConfiguration.Appearance](uikit/uicollectionlayoutlistconfiguration-swift.struct/appearance-swift.enum.md)

### Configuring separators

- [showsSeparators](uikit/uicollectionlayoutlistconfiguration-swift.struct/showsseparators.md)
- [separatorConfiguration](uikit/uicollectionlayoutlistconfiguration-swift.struct/separatorconfiguration.md)
- [UIListSeparatorConfiguration](uikit/uilistseparatorconfiguration-swift.struct.md)
- [itemSeparatorHandler](uikit/uicollectionlayoutlistconfiguration-swift.struct/itemseparatorhandler-swift.property.md)
- [UICollectionLayoutListConfiguration.ItemSeparatorHandler](uikit/uicollectionlayoutlistconfiguration-swift.struct/itemseparatorhandler-swift.typealias.md)

### Configuring headers and footers

- [headerMode](uikit/uicollectionlayoutlistconfiguration-swift.struct/headermode-swift.property.md)
- [footerMode](uikit/uicollectionlayoutlistconfiguration-swift.struct/footermode-swift.property.md)
- [UICollectionLayoutListConfiguration.HeaderMode](uikit/uicollectionlayoutlistconfiguration-swift.struct/headermode-swift.enum.md)
- [UICollectionLayoutListConfiguration.FooterMode](uikit/uicollectionlayoutlistconfiguration-swift.struct/footermode-swift.enum.md)
- [headerTopPadding](uikit/uicollectionlayoutlistconfiguration-swift.struct/headertoppadding.md)

### Customizing swipe actions

- [leadingSwipeActionsConfigurationProvider](uikit/uicollectionlayoutlistconfiguration-swift.struct/leadingswipeactionsconfigurationprovider.md)
- [trailingSwipeActionsConfigurationProvider](uikit/uicollectionlayoutlistconfiguration-swift.struct/trailingswipeactionsconfigurationprovider.md)
- [UICollectionLayoutListConfiguration.SwipeActionsConfigurationProvider](uikit/uicollectionlayoutlistconfiguration-swift.struct/swipeactionsconfigurationprovider.md)

### Managing content-hugging behavior

- [contentHuggingElements](uikit/uicollectionlayoutlistconfiguration-swift.struct/contenthuggingelements-swift.property.md)
- [UICollectionLayoutListConfiguration.ContentHuggingElements](uikit/uicollectionlayoutlistconfiguration-swift.struct/contenthuggingelements-swift.struct.md)

## See Also

### Related Documentation

- [list(using:layoutEnvironment:)](uikit/nscollectionlayoutsection/list(using:layoutenvironment:).md)

### Creating a list layout

- [list(using:)](uikit/uicollectionviewcompositionallayout/list(using:).md)