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

# UINavigationBarAppearance

An object for customizing the appearance of a navigation bar.

```
@MainActor class UINavigationBarAppearance
```

## Overview

After creating a [`UINavigationBarAppearance`](/documentation/UIKit/UINavigationBarAppearance) object, use the methods and properties of this class to specify the appearance you want for items in the navigation bar. Use the inherited properties from [`UIBarAppearance`](/documentation/UIKit/UIBarAppearance) to configure the background and shadow attributes of the navigation bar itself.

## Topics

### Configuring the title

[`titleTextAttributes`](/documentation/UIKit/UINavigationBarAppearance/titleTextAttributes)

String attributes to apply to the text of a standard-size title.

[`largeTitleTextAttributes`](/documentation/UIKit/UINavigationBarAppearance/largeTitleTextAttributes)

String attributes to apply to the text of a large-size title.

[`titlePositionAdjustment`](/documentation/UIKit/UINavigationBarAppearance/titlePositionAdjustment)

The distance, in points, by which to offset the title horizontally and vertically.

### Configuring the subtitle

[`subtitleTextAttributes`](/documentation/UIKit/UINavigationBarAppearance/subtitleTextAttributes)

The default text attributes to apply to the subtitle rendered in the navigation bar.

[`largeSubtitleTextAttributes`](/documentation/UIKit/UINavigationBarAppearance/largeSubtitleTextAttributes)

The default text attributes to apply to the subtitle when it’s rendered under
the large title.

### Configuring bar button items

[`buttonAppearance`](/documentation/UIKit/UINavigationBarAppearance/buttonAppearance)

The appearance attributes for plain bar button items in the navigation bar.

### Configuring the Back button

[`backButtonAppearance`](/documentation/UIKit/UINavigationBarAppearance/backButtonAppearance)

The appearance attributes for the back button.

[`backIndicatorImage`](/documentation/UIKit/UINavigationBarAppearance/backIndicatorImage)

The image to display on the leading edge of the back button.

[`backIndicatorTransitionMaskImage`](/documentation/UIKit/UINavigationBarAppearance/backIndicatorTransitionMaskImage)

The image for masking content flowing under the back indicator image during push and pop transitions.

[`setBackIndicatorImage(_:transitionMaskImage:)`](/documentation/UIKit/UINavigationBarAppearance/setBackIndicatorImage(_:transitionMaskImage:))

Sets the back button indicator image and its transition mask.

### Configuring the Done button

[`doneButtonAppearance`](/documentation/UIKit/UINavigationBarAppearance/doneButtonAppearance)

The appearance attributes for Done buttons.


---

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)