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

# UITabBarItemAppearance

An object for customizing the appearance of tab bar items.

```
@MainActor class UITabBarItemAppearance
```

## Overview

Use a [`UITabBarItemAppearance`](/documentation/UIKit/UITabBarItemAppearance) object to customize the appearance of a tab bar item in each of its possible states. You can customize the appearance differently for each state. For example, you might apply different colors to the tab bar item’s icon in the [`normal`](/documentation/UIKit/UITabBarItemAppearance/normal) and [`selected`](/documentation/UIKit/UITabBarItemAppearance/selected) states.

## Topics

### Creating a tab bar item appearance object

[`init(style:)`](/documentation/UIKit/UITabBarItemAppearance/init(style:))

Creates an appearance object with appropriate default values for a tab bar, displaying its items with the specified layout style.

[`init()`](/documentation/UIKit/UITabBarItemAppearance/init())

Creates an appearance object with default values for a stacked tab bar item.

[`init(coder:)`](/documentation/UIKit/UITabBarItemAppearance/init(coder:))

Creates an appearance object from data in an unarchiver.

### Copying a tab bar item appearance object

[`copy()`](/documentation/UIKit/UITabBarItemAppearance/copy())

Creates a copy of the appearance object.

### Resetting the appearance properties

[`configureWithDefault(for:)`](/documentation/UIKit/UITabBarItemAppearance/configureWithDefault(for:))

Configures the tab bar item appearance object with appropriate values for the specified style.

[`UITabBarItemAppearance.Style`](/documentation/UIKit/UITabBarItemAppearance/Style)

Constants indicating the layout of a tab bar item’s content.

### Configuring attributes for different item states

[`normal`](/documentation/UIKit/UITabBarItemAppearance/normal)

The appearance data to apply to the tab bar item when it’s enabled, unselected, and not the focused item.

[`selected`](/documentation/UIKit/UITabBarItemAppearance/selected)

The appearance data to apply to the tab bar item when it’s selected.

[`disabled`](/documentation/UIKit/UITabBarItemAppearance/disabled)

The appearance data to apply to the tab bar item when it’s disabled.

[`focused`](/documentation/UIKit/UITabBarItemAppearance/focused)

The appearance data to apply to the tab bar item when it’s focused.


---

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)