---
title: UIListSeparatorConfiguration
framework: uikit
role: symbol
role_heading: Structure
path: uikit/uilistseparatorconfiguration-swift.struct
---

# UIListSeparatorConfiguration

A configuration that controls the list separator appearance in a list section.

## Declaration

```swift
struct UIListSeparatorConfiguration
```

## Overview

Overview To specify list separator appearance for a section, set a default sectionwide separatorConfiguration on your UICollectionLayoutListConfiguration when you create your list. var listConfig = UICollectionLayoutListConfiguration(appearance: .plain) listConfig.separatorConfiguration.color = .tertiarySystemFill let layout = UICollectionViewCompositionalLayout.list(using: listConfig) To override list separator appearance on a per-item basis, use the itemSeparatorHandler property. var listConfig = UICollectionLayoutListConfiguration(appearance: .plain) listConfig.separatorConfiguration.color = .tertiarySystemFill

let indexPathToHide = IndexPath()   listConfig.itemSeparatorHandler = { (indexPath, sectionSeparatorConfiguration) in         var configuration = sectionSeparatorConfiguration     if indexPath == indexPathToHide {         configuration.bottomSeparatorVisibility = .hidden         }         return configuration }

let layout = UICollectionViewCompositionalLayout.list(using: listConfig)

## Topics

### Creating a list separator configuration

- [init(listAppearance:)](uikit/uilistseparatorconfiguration-swift.struct/init(listappearance:).md)

### Controlling separator visibility

- [topSeparatorVisibility](uikit/uilistseparatorconfiguration-swift.struct/topseparatorvisibility.md)
- [bottomSeparatorVisibility](uikit/uilistseparatorconfiguration-swift.struct/bottomseparatorvisibility.md)
- [UIListSeparatorConfiguration.Visibility](uikit/uilistseparatorconfiguration-swift.struct/visibility.md)

### Configuring separator insets

- [topSeparatorInsets](uikit/uilistseparatorconfiguration-swift.struct/topseparatorinsets.md)
- [bottomSeparatorInsets](uikit/uilistseparatorconfiguration-swift.struct/bottomseparatorinsets.md)
- [automaticInsets](uikit/uilistseparatorconfiguration-swift.struct/automaticinsets.md)

### Configuring separator appearance

- [color](uikit/uilistseparatorconfiguration-swift.struct/color.md)
- [multipleSelectionColor](uikit/uilistseparatorconfiguration-swift.struct/multipleselectioncolor.md)
- [visualEffect](uikit/uilistseparatorconfiguration-swift.struct/visualeffect.md)

## Relationships

### Conforms To

- [Copyable](swift/copyable.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomReflectable](swift/customreflectable.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)
- [Hashable](swift/hashable.md)

## See Also

### Configuring separators

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