<!--
{
  "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/UITab",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:objc(cs)UITab"
  },
  "title" : "UITab"
}
-->

# UITab

An object that manages a tab in a tab bar.

```
@MainActor class UITab
```

## Overview

To create a tab, call [`init(title:image:identifier:viewControllerProvider:)`](/documentation/UIKit/UITab/init(title:image:identifier:viewControllerProvider:)). In the closure, return the view controller your app presents when someone selects the tab. Then pass an array of tabs to your [`UITabBarController`](/documentation/UIKit/UITabBarController) object’s tabs property.

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 tabs

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

Creates a tab object.

### Accessing a tab’s appearance

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

A tab’s title.

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

A tab’s subtitle.

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

A string identifier for a tab.

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

A tab’s image.

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

A tab’s badge value.

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

The view controller that the system presents when someone selects a tab.

### Managing customization

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

A Boolean value that indicates whether an item is hidden in a sidebar.

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

A Boolean value that indicates whether an item is hidden by default.

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

A Boolean value that indicates whether people can hide a tab in a sidebar.

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

The preferred placement for a tab when displayed in contexts that allow different placement.

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

A tab’s placement when displayed in contexts that allow different placement.

### Accessing context

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

The containing tab group.

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

The containing tab bar controller.

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

A custom object associated with the tab.

## Relationships

### Conforms To

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

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

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

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

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

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

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

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

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

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

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

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

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

### Inherited By

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

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

---

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)