Button labels

A button label is text that appears on a call-to-action button in the UI. All buttons need labels. Follow these guidelines when writing button labels:

• Write concise button text. Aim for 1 or 2 words and no more than 4 words.
• Omit the noun unless it's necessary to add clarity.
• Avoid using "Yes" or "No". Instead, write a clear call to action. Be specific so that the user is sure of what action happens after they select the button.
• If the button text requires more than 1 word, start the text with a verb.
• Use a precise verb to describe the action. For example, use "Add" when using an existing object in a new context, and use "Create" when making a new object from scratch.
• Use sentence-style capitalization and capitalize the first word and proper nouns only.
• Avoid articles such as "a", "an", or "the".
• Don't use punctuation such as periods or exclamation marks.

Examples

The following table shows examples of what to do and what not to do when writing button labels:

Do this	Don't do this
Cancel	No
Save	Yes
Create dashboard	Create Dashboard
Create table view	Create a table view
Continue to tour	Continue to the tour!

For buttons inside dialog boxes, omit the noun in the button if it is already communicated clearly in the dialog box header or body text. For example, if your dialog box is titled Create dashboard, Create is a better button label than Create dashboard:

For buttons that lack clear context, such as in a toolbar, include the noun for clarity. For example, if your dialog box is titled Log Observer, Run search is a better button label than Run: