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

# Legacy customizations

Customize appearance information directly on the toolbar object.

## Discussion

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

## Topics

### Setting the bar’s style

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

The toolbar style that specifies its appearance.

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

Defines the stylistic appearance of different types of views.

### Configuring bar button items

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

The tint color to apply to the bar button items.

### Changing the background

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

The tint color to apply to the toolbar background.

[`-  backgroundImageForToolbarPosition:barMetrics:`](/documentation/UIKit/UIToolbar/backgroundImage(forToolbarPosition:barMetrics:))

Returns the image to use for the background in a given position and with given metrics.

[`-  setBackgroundImage:forToolbarPosition:barMetrics:`](/documentation/UIKit/UIToolbar/setBackgroundImage(_:forToolbarPosition:barMetrics:))

Sets the image to use for the background in a given position and with given metrics.

### Adding a shadow

[`-  shadowImageForToolbarPosition:`](/documentation/UIKit/UIToolbar/shadowImage(forToolbarPosition:))

Returns the image to use for the toolbar shadow in a given position.

[`-  setShadowImage:forToolbarPosition:`](/documentation/UIKit/UIToolbar/setShadowImage(_:forToolbarPosition:))

Sets the image to use for the toolbar shadow in a given position.

### Deprecated

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

Constants to identify the position of a toolbar for appearance customization.


---

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)