---
title: Lists
framework: swiftui
role: collectionGroup
role_heading: API Collection
path: swiftui/lists
---

# Lists

Display a structured, scrollable column of information.

## Overview

Overview Use a list to display a one-dimensional vertical collection of views.

The list is a complex container type that automatically provides scrolling when it grows too large for the current display. You build a list by providing it with individual views for the rows in the list, or by using a ForEach to enumerate a group of rows. You can also mix these strategies, blending any number of individual views and ForEach constructs. Use view modifiers to configure the appearance and behavior of a list and its rows, headers, sections, and separators. For example, you can apply a style to the list, add swipe gestures to individual rows, or make the list refreshable with a pull-down gesture. You can also use the configuration associated with Scroll views to control the list’s implicit scrolling behavior. For design guidance, see Lists and tables in the Human Interface Guidelines.

## Topics

### Creating a list

- [Displaying data in lists](swiftui/displaying-data-in-lists.md)
- [List](swiftui/list.md)
- [listStyle(_:)](swiftui/view/liststyle(_:).md)

### Disclosing information progressively

- [OutlineGroup](swiftui/outlinegroup.md)
- [DisclosureGroup](swiftui/disclosuregroup.md)
- [disclosureGroupStyle(_:)](swiftui/view/disclosuregroupstyle(_:).md)

### Configuring a list’s layout

- [listRowInsets(_:)](swiftui/view/listrowinsets(_:).md)
- [listRowInsets(_:_:)](swiftui/view/listrowinsets(_:_:).md)
- [defaultMinListRowHeight](swiftui/environmentvalues/defaultminlistrowheight.md)
- [defaultMinListHeaderHeight](swiftui/environmentvalues/defaultminlistheaderheight.md)
- [listRowSpacing(_:)](swiftui/view/listrowspacing(_:).md)
- [listSectionSpacing(_:)](swiftui/view/listsectionspacing(_:).md)
- [ListSectionSpacing](swiftui/listsectionspacing.md)
- [listSectionMargins(_:_:)](swiftui/view/listsectionmargins(_:_:).md)

### Configuring rows

- [listItemTint(_:)](swiftui/view/listitemtint(_:).md)
- [ListItemTint](swiftui/listitemtint.md)

### Configuring headers

- [headerProminence(_:)](swiftui/view/headerprominence(_:).md)
- [headerProminence](swiftui/environmentvalues/headerprominence.md)
- [Prominence](swiftui/prominence.md)

### Configuring separators

- [listRowSeparatorTint(_:edges:)](swiftui/view/listrowseparatortint(_:edges:).md)
- [listSectionSeparatorTint(_:edges:)](swiftui/view/listsectionseparatortint(_:edges:).md)
- [listRowSeparator(_:edges:)](swiftui/view/listrowseparator(_:edges:).md)
- [listSectionSeparator(_:edges:)](swiftui/view/listsectionseparator(_:edges:).md)

### Configuring backgrounds

- [listRowBackground(_:)](swiftui/view/listrowbackground(_:).md)
- [alternatingRowBackgrounds(_:)](swiftui/view/alternatingrowbackgrounds(_:).md)
- [AlternatingRowBackgroundBehavior](swiftui/alternatingrowbackgroundbehavior.md)
- [backgroundProminence](swiftui/environmentvalues/backgroundprominence.md)
- [BackgroundProminence](swiftui/backgroundprominence.md)

### Displaying a badge on a list item

- [badge(_:)](swiftui/view/badge(_:).md)
- [badgeProminence(_:)](swiftui/view/badgeprominence(_:).md)
- [badgeProminence](swiftui/environmentvalues/badgeprominence.md)
- [BadgeProminence](swiftui/badgeprominence.md)

### Configuring interaction

- [swipeActions(edge:allowsFullSwipe:content:)](swiftui/view/swipeactions(edge:allowsfullswipe:content:).md)
- [selectionDisabled(_:)](swiftui/view/selectiondisabled(_:).md)
- [listRowHoverEffect(_:)](swiftui/view/listrowhovereffect(_:).md)
- [listRowHoverEffectDisabled(_:)](swiftui/view/listrowhovereffectdisabled(_:).md)

### Refreshing a list’s content

- [refreshable(action:)](swiftui/view/refreshable(action:).md)
- [refresh](swiftui/environmentvalues/refresh.md)
- [RefreshAction](swiftui/refreshaction.md)

### Editing a list

- [moveDisabled(_:)](swiftui/view/movedisabled(_:).md)
- [deleteDisabled(_:)](swiftui/view/deletedisabled(_:).md)
- [editMode](swiftui/environmentvalues/editmode.md)
- [EditMode](swiftui/editmode.md)
- [EditActions](swiftui/editactions.md)
- [EditableCollectionContent](swiftui/editablecollectioncontent.md)
- [IndexedIdentifierCollection](swiftui/indexedidentifiercollection.md)

### Configuring a section index

- [listSectionIndexVisibility(_:)](swiftui/view/listsectionindexvisibility(_:).md)
- [sectionIndexLabel(_:)](swiftui/view/sectionindexlabel(_:).md)

## See Also

### View layout

- [Layout fundamentals](swiftui/layout-fundamentals.md)
- [Layout adjustments](swiftui/layout-adjustments.md)
- [Custom layout](swiftui/custom-layout.md)
- [Tables](swiftui/tables.md)
- [View groupings](swiftui/view-groupings.md)
- [Scroll views](swiftui/scroll-views.md)