<!--
{
  "availability" : [
    "iOS: 14.0.0 -",
    "iPadOS: 14.0.0 -",
    "macCatalyst: 14.0.0 -",
    "tvOS: 14.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UIListContentView",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:objc(cs)UIListContentView"
  },
  "title" : "UIListContentView"
}
-->

# UIListContentView

A content view for displaying list-based content.

```
@MainActor class UIListContentView
```

## Overview

You use a list content view for displaying list-based content in a custom view hierarchy. You can embed a list content view manually in a custom cell or in a container view, like a [`UIStackView`](/documentation/UIKit/UIStackView). You can use Auto Layout or manual layout techniques to size and position the view, and its height adjusts dynamically according to its width and the space it needs to display its content.

A list content view relies on its list content configuration to supply its styling and content. You create a list content view by passing in a [`UIListContentConfiguration`](/documentation/UIKit/UIListContentConfiguration-swift.struct) to [`init(configuration:)`](/documentation/UIKit/UIListContentView/init(configuration:)) (Swift) or [`initWithConfiguration:`](/documentation/UIKit/UIListContentView/initWithConfiguration:) (Objective-C). To update the content view, you set a new configuration on it through its [`configuration`](/documentation/UIKit/UIListContentView/configuration) property.

If you’re using a [`UICollectionView`](/documentation/UIKit/UICollectionView) or [`UITableView`](/documentation/UIKit/UITableView), you don’t need to manually create a list content view to take advantage of the list configuration. Instead, you assign a [`UIListContentConfiguration`](/documentation/UIKit/UIListContentConfiguration-swift.struct) to the [`contentConfiguration`](/documentation/UIKit/UICollectionViewCell/contentConfiguration-1lcqh) property of the cells, headers, or footers within those types.

## Topics

### Creating a list content view

[`init(configuration:)`](/documentation/UIKit/UIListContentView/init(configuration:))

Creates a list content view with the specified content configuration.

[`-  initWithConfiguration:`](/documentation/UIKit/UIListContentView/initWithConfiguration:)

Creates a list content view with the specified content configuration.

[`-  initWithCoder:`](/documentation/UIKit/UIListContentView/init(coder:))

Creates a list content view from data in an unarchiver.

### Managing the content configuration

[`configuration`](/documentation/UIKit/UIListContentView/configuration)

The current configuration of the view.

### Managing the content layout

[`textLayoutGuide`](/documentation/UIKit/UIListContentView/textLayoutGuide)

A guide for positioning the primary text in the content view.

[`secondaryTextLayoutGuide`](/documentation/UIKit/UIListContentView/secondaryTextLayoutGuide)

A guide for positioning the secondary text in the content view.

[`imageLayoutGuide`](/documentation/UIKit/UIListContentView/imageLayoutGuide)

A guide for positioning the image in the content view.

## Relationships

### Conforms To

[`Copyable`](/documentation/Swift/Copyable)

[`UITraitEnvironment`](/documentation/UIKit/UITraitEnvironment)

[`CALayerDelegate`](/documentation/QuartzCore/CALayerDelegate)

[`UIPasteConfigurationSupporting`](/documentation/UIKit/UIPasteConfigurationSupporting)

[`Escapable`](/documentation/Swift/Escapable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`UIDynamicItem`](/documentation/UIKit/UIDynamicItem)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`UIFocusItem`](/documentation/UIKit/UIFocusItem)

[`CLBodyIdentifiable`](/documentation/CoreLocation/CLBodyIdentifiable)

[`UIResponderStandardEditActions`](/documentation/UIKit/UIResponderStandardEditActions)

[`NSTouchBarProvider`](/documentation/AppKit/NSTouchBarProvider)

[`UIFocusEnvironment`](/documentation/UIKit/UIFocusEnvironment)

[`Equatable`](/documentation/Swift/Equatable)

[`CMBodyIdentifiable`](/documentation/CoreMotion/CMBodyIdentifiable)

[`UILargeContentViewerItem`](/documentation/UIKit/UILargeContentViewerItem)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`UICoordinateSpace`](/documentation/UIKit/UICoordinateSpace)

[`NSCoding`](/documentation/Foundation/NSCoding)

[`Sendable`](/documentation/Swift/Sendable)

[`UIUserActivityRestoring`](/documentation/UIKit/UIUserActivityRestoring)

[`UIAppearanceContainer`](/documentation/UIKit/UIAppearanceContainer)

[`UIActivityItemsConfigurationProviding`](/documentation/UIKit/UIActivityItemsConfigurationProviding)

[`UIAccessibilityIdentification`](/documentation/UIKit/UIAccessibilityIdentification)

[`UITraitChangeObservable-67e94`](/documentation/UIKit/UITraitChangeObservable-67e94)

[`Hashable`](/documentation/Swift/Hashable)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`UIAppearance`](/documentation/UIKit/UIAppearance)

[`UIContentView-5fh3z`](/documentation/UIKit/UIContentView-5fh3z)

[`CVarArg`](/documentation/Swift/CVarArg)

[`UIFocusItemContainer`](/documentation/UIKit/UIFocusItemContainer)

[`UIPopoverPresentationControllerSourceItem`](/documentation/UIKit/UIPopoverPresentationControllerSourceItem)

### Inherits From

[`UIView`](/documentation/UIKit/UIView)

---

Copyright &copy; 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)