Buttons

A button performs an app-specific action. Buttons have customizable backgrounds and rounded corners, and they can contain a label, an image, or a group.

Screenshot of a Maps screen, highlighted to show the Search and Location buttons that appear side by side just below the navigation bar.

Prefer buttons that span the width of the screen. Full-width buttons look better and are easier for people to tap. If two buttons must share the same horizontal space, use the same height for both and use images or short text titles for each button’s content.

Use the same height for vertical stacks of one- and two-line text buttons. As much as possible, use identical button heights for visual consistency.

Use the system-defined corner radius. The system defines corner radius values that provide a consistent visual style across apps and reinforce the interactivity of buttons. In Apple Watch Series 4 and later, corner radius values differ depending on whether the button is in a scrolling or nonscrolling view.

Screenshot of a black screen that contains two pill shaped buttons stacked at the bottom of the screen. The top button is gray and displays the word Label in white text. The bottom button is blue and displays the word Label in black text.

In nonscrolling views, buttons use a 22-point corner radius.

Screenshot of a black screen that contains two rounded rectangle buttons stacked at the bottom of the screen. Both buttons extend from side to side, but the bottom edge of the bottom button is slightly cut off by the bezel. The top button is gray and displays the word Cancel in white text. The bottom button is blue and displays the word Primary in white text.

In scrolling views, buttons use a 9-point corner radius.

In Apple Watch Series 3 and earlier, buttons use an 8-point corner radius, regardless of whether they appear in a scrolling or nonscrolling view.

Make sure buttons are tappable, even when they aren't full-width. If a button's hit region is too small, it can make people feel that they have to be extra precise to tap it. Use the minimum size values in the table below to help you determine if you need to add padding around a button to create a comfortable hit region.

Series 4 and later Series 3 and earlier
Button shape (dimension) 40mm 44mm 38mm 42mm
Circle (diameter) 40pts 42pts 38pts 40pts
Rounded rectangle (height) 40pts 44pts 38pts 40pts

For developer guidance, see Button (SwiftUI) and WKInterfaceButton (WatchKit).