--- title: "Custom List Section Spacing | Explore SwiftUI" description: "Sets the spacing between adjacent sections in a List to a custom value. Learn how to use Custom List Section Spacing in SwiftUI with visual code examples." canonical_url: "https://exploreswiftui.com/library/list/custom-list-section-spacing" meta: author: "Explore SwiftUI" "og:description": "Sets the spacing between adjacent sections in a List to a custom value. Learn how to use Custom List Section Spacing in SwiftUI with visual code examples." "og:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_Custom%2BList%2BSection%2BSpacing%2Cdescription_Sets%2Bthe%2Bspacing%2Bbetween%2Badjacent%2Bsections%2Bin%2Ba%2BList%2Bto%2Ba%2Bcustom%2Bvalue.%2Ccategory_List%2Cimage_~L2FwaS9pbWFnZXMvMTEzL3ZhcmlhbnRzLzk0P3Y9MTc5MDA3MzQ3ODg0MiZyPTImdz0xMjgwJnE9ODUmZj1qcGVn%2CimageMode_crop%2CimagePosition_center%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgdG9wOiA3NXB4OyBib3JkZXItdG9wOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkIHJnYmEoMCwwLDAsMC4wNik7IGJvcmRlci10b3AtbGVmdC1yYWRpdXM6IDMycHg7IGJvcmRlci1ib3R0b20tbGVmdC1yYWRpdXM6IDMycHg7%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwid2F0Y2hPUyIsInZpc2lvbk9TIl19%2Cp_Ii9saWJyYXJ5L2xpc3QvY3VzdG9tLWxpc3Qtc2VjdGlvbi1zcGFjaW5nIg%2Cs_4RN6B3O6Wp2rLNyS.png" "og:image:height": "630" "og:image:type": image/png "og:image:width": "1200" "og:title": "Custom List Section Spacing | Explore SwiftUI" "twitter:description": "Sets the spacing between adjacent sections in a List to a custom value. Learn how to use Custom List Section Spacing in SwiftUI with visual code examples." "twitter:image": "https://exploreswiftui.com/_og/d/c_Component%2Ctitle_Custom%2BList%2BSection%2BSpacing%2Cdescription_Sets%2Bthe%2Bspacing%2Bbetween%2Badjacent%2Bsections%2Bin%2Ba%2BList%2Bto%2Ba%2Bcustom%2Bvalue.%2Ccategory_List%2Cimage_~L2FwaS9pbWFnZXMvMTEzL3ZhcmlhbnRzLzk0P3Y9MTc5MDA3MzQ3ODg0MiZyPTImdz0xMjgwJnE9ODUmZj1qcGVn%2CimageMode_crop%2CimagePosition_center%2CimageFrame_~cG9zaXRpb246IGFic29sdXRlOyByaWdodDogMDsgd2lkdGg6IDY0MHB4OyBoZWlnaHQ6IDQ4MHB4OyBkaXNwbGF5OiBmbGV4OyBvdmVyZmxvdzogaGlkZGVuOyBiYWNrZ3JvdW5kOiAjRkZGRkZGOyBib3gtc2hhZG93OiAwIC0xMHB4IDUwcHggcmdiYSgzNyw5OSwyMzUsMC4xOCk7IGJvcmRlci1sZWZ0OiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgdG9wOiA3NXB4OyBib3JkZXItdG9wOiAxcHggc29saWQgcmdiYSgwLDAsMCwwLjA2KTsgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkIHJnYmEoMCwwLDAsMC4wNik7IGJvcmRlci10b3AtbGVmdC1yYWRpdXM6IDMycHg7IGJvcmRlci1ib3R0b20tbGVmdC1yYWRpdXM6IDMycHg7%2Cprops_eyJwbGF0Zm9ybXMiOlsiaU9TIiwiaVBhZE9TIiwid2F0Y2hPUyIsInZpc2lvbk9TIl19%2Cp_Ii9saWJyYXJ5L2xpc3QvY3VzdG9tLWxpc3Qtc2VjdGlvbi1zcGFjaW5nIg%2Cs_4RN6B3O6Wp2rLNyS.png" "twitter:title": "Custom List Section Spacing | Explore SwiftUI" --- > Index of every page on this site: [llms.txt](https://exploreswiftui.com/llms.txt) **Interactive previews**[ iPhone](https://exploreswiftui.com/iphone?element=113) # **Custom List Section Spacing** Sets the spacing between adjacent sections in a List to a custom value. ![Custom List Section Spacing - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/113/variants/94?v=1790073478842&r=2&w=800&q=80&f=webp) ### **Platform Compatibility** iOS 17.0+ iPadOS 17.0+ watchOS 10.0+ visionOS 1.0+ ### **Tags** ### **SwiftUI Code** [ Docs]() ``` 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](https://exploreswiftui.com/_ipx/f_webp&q_80&s_48x48/images/connect-wizard-icon.png) **Connect Wizard** **Unlock insights App Store Connect doesn’t show you.** [** Get Started **](https://apps.apple.com/app/apple-store/id6747314580?pt=121213751&ct=Explore%20SwiftUI%20Banner&mt=8) ### **More List Components ** [**View all **](https://exploreswiftui.com/library/list) ![Outline Group - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/132/variants/371?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Outline Group** A structure that computes views and disclosure groups on demand from an underlying collection of tree-structured, identified data. ![Disclosure Group - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/131/variants/363?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Disclosure Group** A view that shows or hides another content view, based on the state of a disclosure control. ![Edit Button - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/130/variants/367?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Edit Button** A button that toggles the edit mode environment value. ![Section Index Label and Visibility - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/129/variants/369?v=1790073478842&r=2&w=412&q=75&f=webp) ### **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. ![Move Disabled - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/128/variants/361?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Move Disabled** Adds a condition for whether the view’s view hierarchy is movable. ![Delete Disabled - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/127/variants/351?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Delete Disabled** Adds a condition for whether the view’s view hierarchy is deletable. ![Refreshable List - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/126/variants/359?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Refreshable List** Marks this view as refreshable. ![Swipe Action - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview](https://exploreswiftui.com/api/images/125/variants/357?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Swipe Action** Adds custom swipe actions to a row in a list. ### **Explore Other Components ** [**Browse all **](https://exploreswiftui.com/) ![CircularProgressViewStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/80/variants/86?v=1790073478842&r=2&w=412&q=75&f=webp) ### **CircularProgressViewStyle** The style of a progress view that uses a circular gauge to indicate the partial completion of an activity ![Content Unavailable - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/4/variants/37?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Content Unavailable** A placeholder for empty results with optional button ![Tab View Customization Behavior - iPadOS - Landscape - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/166/variants/669?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Tab View Customization Behavior** Configures the customization behavior of customizable tab view content. ![Sheet Background Interaction - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/140/variants/434?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Sheet Background Interaction** Controls whether people can interact with the view behind a presentation. ![AccessoryLinearGaugeStyle - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/44/variants/253?v=1790073478842&r=2&w=412&q=75&f=webp) ### **AccessoryLinearGaugeStyle** A gauge style that displays bar with a marker that appears at a point along the bar to indicate the gauge’s current value ![Button Roles - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/33/variants/718?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Button Roles** A value that describes the purpose of a button. ![Menu Divider - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/20/variants/128?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Menu Divider** A Menu with a Divider ![Button Sizing - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview](https://exploreswiftui.com/api/images/190/variants/3?v=1790073478842&r=2&w=412&q=75&f=webp) ### **Button Sizing** The preferred sizing behavior of buttons in the view hierarchy. ```json {"@context":"https://schema.org","@graph":[{"@id":"https://exploreswiftui.com/#website","@type":"WebSite","description":"A visual library for SwiftUI APIs, components, and modifiers","inLanguage":"en-US","name":"Explore SwiftUI","url":"https://exploreswiftui.com/","publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/list/custom-list-section-spacing#webpage","@type":"WebPage","dateModified":"2025-08-06T13:43:52.860Z","datePublished":"2025-08-06T13:41:25.124Z","description":"Sets the spacing between adjacent sections in a List to a custom value. Learn how to use Custom List Section Spacing in SwiftUI with visual code examples.","name":"Custom List Section Spacing","url":"https://exploreswiftui.com/library/list/custom-list-section-spacing","breadcrumb":{"@id":"https://exploreswiftui.com/library/list/custom-list-section-spacing#breadcrumb"},"isPartOf":{"@id":"https://exploreswiftui.com/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://exploreswiftui.com/library/list/custom-list-section-spacing"]}],"primaryImageOfPage":{"@id":"https://exploreswiftui.com/#logo"}},{"@id":"https://exploreswiftui.com/#identity","@type":"Organization","description":"A visual library for SwiftUI APIs, components, and modifiers","name":"Explore SwiftUI","url":"https://exploreswiftui.com","logo":{"@id":"https://exploreswiftui.com/#logo"},"sameAs":["https://x.com/Typ0genius","https://mastodon.social/@Typ0genius"]},{"@id":"https://exploreswiftui.com/library/list/custom-list-section-spacing#article","dateModified":"2025-08-06T13:43:52.860Z","datePublished":"2025-08-06T13:41:25.124Z","description":"Sets the spacing between adjacent sections in a List to a custom value. Learn how to use Custom List Section Spacing in SwiftUI with visual code examples.","headline":"Custom List Section Spacing","inLanguage":"en-US","name":"Custom List Section Spacing","thumbnailUrl":"https://exploreswiftui.com/api/images/113/variants/94?v=1790073478842&r=2","url":"https://exploreswiftui.com/library/list/custom-list-section-spacing","@type":["Article","TechArticle"],"about":{"@type":"Thing","name":"SwiftUI"},"author":{"@id":"https://exploreswiftui.com/#identity"},"image":{"@id":"https://exploreswiftui.com/#/schema/image/1"},"isPartOf":{"@type":"WebSite","name":"Explore SwiftUI","url":"https://exploreswiftui.com"},"mainEntityOfPage":{"@id":"https://exploreswiftui.com/library/list/custom-list-section-spacing#webpage"},"publisher":{"@id":"https://exploreswiftui.com/#identity"}},{"@id":"https://exploreswiftui.com/library/list/custom-list-section-spacing#/schema/software-source-code/1","@type":"SoftwareSourceCode","codeRepository":"https://developer.apple.com/documentation/swiftui/view/listsectionspacing(_:)","codeSampleType":"full example","description":"Sets the spacing between adjacent sections in a List to a custom value. Learn how to use Custom List Section Spacing in SwiftUI with visual code examples.","name":"Custom List Section Spacing SwiftUI Example","programmingLanguage":"Swift","runtimePlatform":"SwiftUI","text":"List {\n Section(\"Header\") {\n Text(\"Foo\")\n }\n Section(\"Header\") {\n Text(\"Bar\")\n }\n .listSectionSpacing(42)\n Section(\"Header\") {\n Text(\"Foo\")\n }\n}","about":[{"@type":"Thing","name":"SwiftUI"},{"@type":"Thing","name":"List"},{"@type":"Thing","name":"Custom List Section Spacing"}]},{"@id":"https://exploreswiftui.com/library/list/custom-list-section-spacing#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Home","item":"https://exploreswiftui.com","position":1},{"@type":"ListItem","name":"List","item":"https://exploreswiftui.com/library/list","position":2},{"@type":"ListItem","name":"Custom List Section Spacing","item":"https://exploreswiftui.com/library/list/custom-list-section-spacing","position":3}]},{"@id":"https://exploreswiftui.com/#logo","@type":"ImageObject","caption":"Explore SwiftUI","contentUrl":"https://exploreswiftui.com/apple-touch-icon.png","inLanguage":"en","url":"https://exploreswiftui.com/apple-touch-icon.png"},{"@id":"https://exploreswiftui.com/#/schema/image/1","@type":"ImageObject","contentUrl":"https://exploreswiftui.com/api/images/113/variants/94?v=1790073478842&r=2","inLanguage":"en","url":"https://exploreswiftui.com/api/images/113/variants/94?v=1790073478842&r=2"}]} ```