<!--
{
  "documentType" : "article",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/uinavigationbar-legacy-customizations",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Legacy customizations"
}
-->

# Legacy customizations

Customize appearance information directly on the navigation bar object.

## Discussion

In iOS 13 and later, customize your navigation bar using the [`standardAppearance`](/documentation/UIKit/UINavigationBar/standardAppearance), [`compactAppearance`](/documentation/UIKit/UINavigationBar/compactAppearance), and [`scrollEdgeAppearance`](/documentation/UIKit/UINavigationBar/scrollEdgeAppearance) properties. You may continue to use these legacy accessors to customize your navigation bar’s appearance directly, but you must update the appearance for different bar configurations yourself.

## Topics

### Configuring the navigation bar

[Customizing your app’s navigation bar](/documentation/UIKit/customizing-your-app-s-navigation-bar)

Create custom titles, prompts, and buttons in your app’s navigation bar.

### Setting the bar’s style

[`barStyle`](/documentation/UIKit/UINavigationBar/barStyle)

The navigation bar style that specifies its appearance.

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

Defines the stylistic appearance of different types of views.

### Configuring the title

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

Display attributes for the bar’s title text.

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

Display attributes for the bar’s large title text.

[`titleVerticalPositionAdjustment(for:)`](/documentation/UIKit/UINavigationBar/titleVerticalPositionAdjustment(for:))

Returns the title’s vertical position adjustment for given bar metrics.

[`setTitleVerticalPositionAdjustment(_:for:)`](/documentation/UIKit/UINavigationBar/setTitleVerticalPositionAdjustment(_:for:))

Sets the title’s vertical position adjustment for given bar metrics.

### Configuring bar button items

[`tintColor`](/documentation/UIKit/UINavigationBar/tintColor)

The tint color to apply to the navigation items and bar button items.

### Configuring the Back button

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

The image shown beside the Back button.

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

The image used as a mask for content during push and pop transitions.

### Changing the background

[`barTintColor`](/documentation/UIKit/UINavigationBar/barTintColor)

The tint color to apply to the navigation bar background.

[`backgroundImage(for:)`](/documentation/UIKit/UINavigationBar/backgroundImage(for:))

Returns the background image for given bar metrics.

[`setBackgroundImage(_:for:)`](/documentation/UIKit/UINavigationBar/setBackgroundImage(_:for:))

Sets the background image for given bar metrics.

[`backgroundImage(for:barMetrics:)`](/documentation/UIKit/UINavigationBar/backgroundImage(for:barMetrics:))

Returns the background image to use for a given bar position and set of metrics.

[`setBackgroundImage(_:for:barMetrics:)`](/documentation/UIKit/UINavigationBar/setBackgroundImage(_:for:barMetrics:))

Sets the background image to use for a given bar position and set of metrics.

### Adding a shadow

[`shadowImage`](/documentation/UIKit/UINavigationBar/shadowImage)

The shadow image to be used for the navigation bar.


---

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)