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

# UITabGroup

An object that manages a collection of tab objects.

```
@MainActor class UITabGroup
```

## Overview

Use tab groups to create a rich hierarchy of tab items. On iPad, the system displays the tab group as a section in the sidebar. For more information, see [Elevating your iPad app with a tab bar and sidebar](/documentation/UIKit/elevating-your-ipad-app-with-a-tab-bar-and-sidebar).

## Topics

### Creating tab groups

[`-  initWithTitle:image:identifier:children:viewControllerProvider:`](/documentation/UIKit/UITabGroup/init(title:image:identifier:children:viewControllerProvider:))

Creates a tab group.

### Accessing tabs

[`children`](/documentation/UIKit/UITabGroup/children)

The tabs within a tab group.

[`-  tabForIdentifier:`](/documentation/UIKit/UITabGroup/tab(forIdentifier:))

Returns a tab with a matching identifier, if any.

[`defaultChildIdentifier`](/documentation/UIKit/UITabGroup/defaultChildIdentifier)

The identifier for the default subitem.

[`selectedChild`](/documentation/UIKit/UITabGroup/selectedChild)

The currently selected tab.

### Configuring a tab group

[`sidebarAppearance`](/documentation/UIKit/UITabGroup/sidebarAppearance-swift.property)

The appearance of a tab group’s section in a sidebar.

[`SidebarAppearance`](/documentation/UIKit/UITabGroup/SidebarAppearance-swift.enum)

The appearance of a section in a sidebar.

[`managingNavigationController`](/documentation/UIKit/UITabGroup/managingNavigationController)

The controller that manages navigation for items in a sidebar.

### Managing customization

[`allowsReordering`](/documentation/UIKit/UITabGroup/allowsReordering)

A Boolean value that indicates people can reorder subitems in the sidebar.

[`displayOrderIdentifiers`](/documentation/UIKit/UITabGroup/displayOrderIdentifiers)

An array that contains the identifiers of subitems in their display order.

[`displayOrder`](/documentation/UIKit/UITabGroup/displayOrder)

An array that contains instances of subitems in their display order.

### Assigning actions

[`sidebarActions`](/documentation/UIKit/UITabGroup/sidebarActions)

An array of actions that appear in a section in a sidebar.

## Relationships

### Conforms To

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

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

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

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

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

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

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

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

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

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

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

### Inherits From

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

---

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)