Buttons initiate app-specific actions, and may contain text or an icon.

Image of Apple TV screen showing Sign In button

In general, use either text or an icon to convey a button’s action. There’s limited space on a button. To prevent crowding and visual complexity, try not to combine text and an icon.

Clearly label and confirm destructive actions. If clicking a button results in a destructive action, such as deleting something, make sure its purpose is crystal clear. Use a descriptive label, such as Delete, or an appropriate icon. It’s also good practice to display an alert asking for confirmation before performing a destructive action.

Don’t include back buttons. People know that pressing Menu on the remote takes them back to the previous screen or the main menu. Unless your app has a legitimate reason to reproduce this functionality with a back button, don’t clutter your interface with one.

Use a Cancel button for confirmation and guidance only. A Cancel button is worth including if it provides clarity, such as instilling confidence a purchase will be canceled or exiting out of a modal dialog without saving any changes that may have been made. In most cases, pressing Menu on the remote should produce the same result as clicking the Cancel button.

For developer guidance, see UIButton.

Button Icons

Use simple, recognizable images as button icons. Icons with too much detail are difficult to interpret on a TV screen. Keep icons simple enough to communicate meaning. When possible, use icons that are commonly associated with an action, such as a magnifying glass for performing a search.

Use accessibility labels to allow audible descriptions of button icons. Accessibility labels help VoiceOver describe icons to people. For guidance, see Accessibility. For developer guidance, see tvOS Accessibility and UIKit Accessibility.

Button Text

If appropriate, show descriptive text beneath an icon button. An icon should generally be sufficient for conveying meaning. However, if additional text provides useful information or context, put it below the button.

Use a verb or a verb phrase to describe a button’s action. An action-specific title denotes interactivity and clearly defines what happens when the button is clicked.

Use title-style capitalization. Capitalize every word of a button title except articles, coordinating conjunctions, and prepositions of four letters or less.

Keep button text short and to the point. Lengthy text may be truncated, making it difficult to read.