---
title: UIToolbar
framework: uikit
role: symbol
role_heading: Class
path: uikit/uitoolbar
---

# UIToolbar

A control that displays one or more buttons along an edge of your interface.

## Declaration

```swift
@MainActor class UIToolbar
```

## Overview

Overview To create toolbar items, use the UIBarButtonItem class. To add toolbar items to a toolbar, use the setItems(_:animated:) method. Toolbar images that represent normal and highlighted states of an item derive from the image you set using the inherited image property from the UIBarItem class. The toolbar’s tintColor colors the image. If you need radio button style controls, use the UITabBar class instead of UIToolbar. When the system presents the toolbar with Liquid Glass: Don’t apply custom backgrounds or appearances to UIToolbar. Instead, let the system determine the background appearance. Don’t use UIToolbar directly when you present your view controller with a UINavigationController. Instead, set toolbarItems to get system-provided transitions and animations in your toolbar. note: In iOS 18 and earlier, you use the methods listed in Customizing appearance to customize the appearance of toolbars. You send the setter messages to the appearance proxy (UIToolbar.appearance() in Swift or [UIToolbar appearance] in Objective-C) to customize all toolbars, or to a specific UIToolbar instance. If a property is dependent on the bar metrics, specify a value for UIBarMetrics.default as well as for UIBarMetrics.compact. Split the toolbar’s shared background By default, the system organizes all of the buttons you provide into one grouping that shares a background in the toolbar. To split buttons into different groupings with separate shared backgrounds, add fixedSpace() between buttons to indicate where you want to split the shared background. For a button that finalizes or completes a task, set the button’s style to UIBarButtonItem.Style.prominent so that the system can avoid visually grouping the button with other buttons.

## Topics

### Managing toolbar changes

- [delegate](uikit/uitoolbar/delegate.md)
- [UIToolbarDelegate](uikit/uitoolbardelegate.md)

### Configuring toolbar items

- [items](uikit/uitoolbar/items.md)
- [setItems(_:animated:)](uikit/uitoolbar/setitems(_:animated:).md)

### Customizing appearance

- [standardAppearance](uikit/uitoolbar/standardappearance.md)
- [compactAppearance](uikit/uitoolbar/compactappearance.md)
- [scrollEdgeAppearance](uikit/uitoolbar/scrolledgeappearance.md)
- [compactScrollEdgeAppearance](uikit/uitoolbar/compactscrolledgeappearance.md)
- [isTranslucent](uikit/uitoolbar/istranslucent.md)
- [Legacy customizations](uikit/uitoolbar-legacy-customizations.md)

## Relationships

### Inherits From

- [UIView](uikit/uiview.md)

### Conforms To

- [CALayerDelegate](quartzcore/calayerdelegate.md)
- [CLBodyIdentifiable](corelocation/clbodyidentifiable.md)
- [CMBodyIdentifiable](coremotion/cmbodyidentifiable.md)
- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSTouchBarProvider](appkit/nstouchbarprovider.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)
- [UIAccessibilityIdentification](uikit/uiaccessibilityidentification.md)
- [UIActivityItemsConfigurationProviding](uikit/uiactivityitemsconfigurationproviding.md)
- [UIAppearance](uikit/uiappearance.md)
- [UIAppearanceContainer](uikit/uiappearancecontainer.md)
- [UIBarPositioning](uikit/uibarpositioning.md)
- [UICoordinateSpace](uikit/uicoordinatespace.md)
- [UIDynamicItem](uikit/uidynamicitem.md)
- [UIFocusEnvironment](uikit/uifocusenvironment.md)
- [UIFocusItem](uikit/uifocusitem.md)
- [UIFocusItemContainer](uikit/uifocusitemcontainer.md)
- [UILargeContentViewerItem](uikit/uilargecontentvieweritem.md)
- [UIPasteConfigurationSupporting](uikit/uipasteconfigurationsupporting.md)
- [UIPopoverPresentationControllerSourceItem](uikit/uipopoverpresentationcontrollersourceitem.md)
- [UIResponderStandardEditActions](uikit/uiresponderstandardeditactions.md)
- [UITraitChangeObservable](uikit/uitraitchangeobservable-67e94.md)
- [UITraitEnvironment](uikit/uitraitenvironment.md)
- [UIUserActivityRestoring](uikit/uiuseractivityrestoring.md)

## See Also

### Bars

- [UIBarItem](uikit/uibaritem.md)
- [UIBarButtonItem](uikit/uibarbuttonitem.md)
- [UIBarButtonItemGroup](uikit/uibarbuttonitemgroup.md)
- [UINavigationBar](uikit/uinavigationbar.md)
- [UISearchBar](uikit/uisearchbar.md)
- [UITabBar](uikit/uitabbar.md)
- [UITabBarItem](uikit/uitabbaritem.md)
- [UIBarPositioning](uikit/uibarpositioning.md)
- [UIBarPositioningDelegate](uikit/uibarpositioningdelegate.md)