Interactive previews iPhone

Custom List Section Spacing

Sets the spacing between adjacent sections in a List to a custom value.

Platform Compatibility

iOS 17.0+ iPadOS 17.0+ watchOS 10.0+ visionOS 1.0+

SwiftUI Code

List {
  Section("Header") {
    Text("Foo")
  }
  Section("Header") {
    Text("Bar")
  }
  .listSectionSpacing(42)
  Section("Header") {
    Text("Foo")
  }
}

Found an issue or have a suggestion?

Created: August 6, 2025Updated: August 6, 2025

Connect Wizard

Unlock insights App Store Connect doesn’t show you.

Get Started

More List Components

View all

initializer

Outline Group

A structure that computes views and disclosure groups on demand from an underlying collection of tree-structured, identified data.

initializer

Disclosure Group

A view that shows or hides another content view, based on the state of a disclosure control.

initializer

Edit Button

A button that toggles the edit mode environment value.

modifier

Section Index Label and Visibility

Sets the label that is used in a section index to point to this section, typically only a single character long. Changes the visibility of the list section index.