<!--
{
  "availability" : [
    "iOS: 18.4.0 -",
    "iPadOS: 18.4.0 -",
    "macCatalyst: 18.4.0 -",
    "macOS: 15.4.0 -",
    "visionOS: 2.4.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/TabViewCustomization/SectionCustomization/tabOrder",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI20TabViewCustomizationV07SectionE0V8tabOrderSaySSGSgvp"
  },
  "title" : "tabOrder"
}
-->

# tabOrder

The order customization for the tabs in a section,
identified by customization identifier.

```
var tabOrder: [String]? { get }
```

## Discussion

Identifiers can be associated with a `Tab` or `TabSection` using the
`customizationID(_:)` modifier.

```
TabSection("Categories") {
    Tab("Climate", systemImage: "fan") {
        ClimateView()
    }
    .customizationID("com.myApp.climate")

    Tab("Lights", systemImage: "lightbulb") {
        LightsView()
    }
    .customizationID("com.myApp.lights")
}
.customizationID("com.myApp.categories")
```

Section tab order can be read by subscripting the customization
with the tab section’s id:

```
let order = customization[section: "com.myApp.categories"].tabOrder
```

If the section has been customized, this returns the current order
for all the tabs in the section, including tabs that have not been
customized. If the section has not been customized or the identifier
does not correspond to a section, the order will be nil to indicate
the tab order matches that of the builder.

---

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)