---
title: UIListContentConfiguration
framework: uikit
role: symbol
role_heading: Structure
path: uikit/uilistcontentconfiguration-swift.struct
---

# UIListContentConfiguration

A content configuration for a list-based content view.

## Declaration

```swift
struct UIListContentConfiguration
```

## Overview

Overview A list content configuration describes the styling and content for an individual element that might appear in a list, like a cell, header, or footer. Using a list content configuration, you can obtain system default styling for a variety of different view states. You fill the configuration with your content, and then assign it directly to cells, headers, and footers in UICollectionView and UITableView, or to your own custom list content view (UIListContentView). For views like cells, headers, and footers, use their defaultContentConfiguration() to get a list content configuration that has preconfigured default styling. Alternatively, you can create a list content configuration from one of the system default styles. After you get the configuration, you assign your content to it, customize any other properties, and assign it to your view as the current content configuration. var content = cell.defaultContentConfiguration()

// Configure content. content.image = UIImage(systemName: "star") content.text = "Favorites"

// Customize appearance. content.imageProperties.tintColor = .purple

cell.contentConfiguration = content

## Topics

### Creating default cell configurations

- [cell()](uikit/uilistcontentconfiguration-swift.struct/cell().md)
- [subtitleCell()](uikit/uilistcontentconfiguration-swift.struct/subtitlecell().md)
- [valueCell()](uikit/uilistcontentconfiguration-swift.struct/valuecell().md)
- [sidebarCell()](uikit/uilistcontentconfiguration-swift.struct/sidebarcell().md)
- [sidebarSubtitleCell()](uikit/uilistcontentconfiguration-swift.struct/sidebarsubtitlecell().md)
- [accompaniedSidebarCell()](uikit/uilistcontentconfiguration-swift.struct/accompaniedsidebarcell().md)
- [accompaniedSidebarSubtitleCell()](uikit/uilistcontentconfiguration-swift.struct/accompaniedsidebarsubtitlecell().md)

### Creating header and footer configurations

- [plainHeader()](uikit/uilistcontentconfiguration-swift.struct/plainheader().md)
- [plainFooter()](uikit/uilistcontentconfiguration-swift.struct/plainfooter().md)
- [groupedHeader()](uikit/uilistcontentconfiguration-swift.struct/groupedheader().md)
- [groupedFooter()](uikit/uilistcontentconfiguration-swift.struct/groupedfooter().md)
- [prominentInsetGroupedHeader()](uikit/uilistcontentconfiguration-swift.struct/prominentinsetgroupedheader().md)
- [extraProminentInsetGroupedHeader()](uikit/uilistcontentconfiguration-swift.struct/extraprominentinsetgroupedheader().md)
- [sidebarHeader()](uikit/uilistcontentconfiguration-swift.struct/sidebarheader().md)

### Customizing content

- [image](uikit/uilistcontentconfiguration-swift.struct/image.md)
- [text](uikit/uilistcontentconfiguration-swift.struct/text.md)
- [attributedText](uikit/uilistcontentconfiguration-swift.struct/attributedtext.md)
- [secondaryText](uikit/uilistcontentconfiguration-swift.struct/secondarytext.md)
- [secondaryAttributedText](uikit/uilistcontentconfiguration-swift.struct/secondaryattributedtext.md)

### Customizing appearance

- [imageProperties](uikit/uilistcontentconfiguration-swift.struct/imageproperties-swift.property.md)
- [textProperties](uikit/uilistcontentconfiguration-swift.struct/textproperties-swift.property.md)
- [secondaryTextProperties](uikit/uilistcontentconfiguration-swift.struct/secondarytextproperties.md)
- [UIListContentConfiguration.ImageProperties](uikit/uilistcontentconfiguration-swift.struct/imageproperties-swift.struct.md)
- [UIListContentConfiguration.TextProperties](uikit/uilistcontentconfiguration-swift.struct/textproperties-swift.struct.md)

### Customizing layout

- [axesPreservingSuperviewLayoutMargins](uikit/uilistcontentconfiguration-swift.struct/axespreservingsuperviewlayoutmargins.md)
- [directionalLayoutMargins](uikit/uilistcontentconfiguration-swift.struct/directionallayoutmargins.md)
- [prefersSideBySideTextAndSecondaryText](uikit/uilistcontentconfiguration-swift.struct/preferssidebysidetextandsecondarytext.md)
- [imageToTextPadding](uikit/uilistcontentconfiguration-swift.struct/imagetotextpadding.md)
- [textToSecondaryTextHorizontalPadding](uikit/uilistcontentconfiguration-swift.struct/texttosecondarytexthorizontalpadding.md)
- [textToSecondaryTextVerticalPadding](uikit/uilistcontentconfiguration-swift.struct/texttosecondarytextverticalpadding.md)

### Instance Properties

- [alpha](uikit/uilistcontentconfiguration-swift.struct/alpha.md)

### Type Methods

- [footer()](uikit/uilistcontentconfiguration-swift.struct/footer().md)
- [header()](uikit/uilistcontentconfiguration-swift.struct/header().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)
- [UIContentConfiguration](uikit/uicontentconfiguration-9eib5.md)

## See Also

### Content configurations

- [UIListContentView](uikit/uilistcontentview.md)
- [UIContentConfiguration](uikit/uicontentconfiguration-9eib5.md)
- [UIContentView](uikit/uicontentview-5fh3z.md)