FOUNDATION
Guidelines for the best words, with the right voice and tone, to help users efficiently complete their tasks.
Writing is design.
UI copy reinforces our brand. Our voice, tone, and visual components work together to create a unified design and experience.
Be succinct.
Write short, active copy that’s easily scannable so users can get to what they want quickly and easily.
Be unambiguous.
Use clear, direct language. Users should know with certainty what an action will do.
Less is more.
Sometimes the best copy choice is no copy.
Write for flows.
Where has the user just come from? Where will they go? Write for a specific action and situate that action within the larger context of the user's task.
Consistency is good. Clarity is better.
Use the same words for the same actions. Sometimes, strict adherence to rules can lead to confusing or inconsistent copy. If 'Place Order' is industry-standard, don’t change it to 'Submit Order' just to be consistent — always prioritize clarity.
Spell out an acronym the first time it’s mentioned. On subsequent references, use the abbreviation. If the abbreviation isn’t clearly related to the full version, specify in parentheses.
If the abbreviation or acronym is well-known to the average client (for example, APR or ROI), use it on first reference without spelling it out.
Write button text in title case when the text is five words or fewer. For text longer than five words, use sentence case.
The desired action goes on the righthand button.
Avoid buttons that simply say "Yes" or "No," which are generic and provide no context. Use clear, predictable language, so that users can reasonably know what will happen when they click. Email Technical Support, for example, brings up a composition window. EXCEPTION: Cancel confirmation messages. See that topic for more.
It’s OK to use an ampersand in button copy.
Use accept only when legal terms of service are required before a user can proceed. Use OK for a read-only page that the user isn't legally required to accept.
OK is all caps, always.
Use cancel to back out of a page where information has been entered or where legal confirmation is required. Use close for read-only messages or screens. Don't use dismiss.
Use select when the user is picking from a limited number of options presented.
Use choose when the user is making an open-ended decision or picking from a large number of options.
Use edit, not manage.
Use create when users are making something new or bringing separate elements together to form something new:
Use add when the user is bringing in information that already exists elsewhere:
Use submit for a form.
Use send only for email.
See is the verb. View is the noun.
Exception: Don't use "see" by itself. In that case, use "view"
Ask, not inquire.
In general, don't go overboard with capitalization. When overused, it makes copy harder to read and sounds stiff, like every word is shouting at you. Terms that truly need to be capitalized, such as the name of our company, stand out more when they're not lost in a sea of unnecessarily capitalized terms.
Example of title case vs sentence case in buttons
Generally avoid contractions, but let your ear be your guide. If writing out the contraction sounds stiff or mechanical, opt for more conversational language, especially when directly communicating with a client.
Dates automatically resolve to customary formats (i.e., day first, month first, year first) according to a user's location. These are guidelines for American English sites.
Use this format (seconds/time zones may not always be necessary): 3:52:17 AM PST
Formatting can be localized where needed and typically follows the formats below
+1-212-123-4567
+44-20-1234-5678
+65-1234-5678
+1 212-123-4567
+44 20-1234-5678
+65 1234-5678
Dialogs ask users to take an action–to acknowledge, dismiss, confirm, or allow something. These are pop-up modals that interrupt workflows, so use them only when the inconvenience is warranted.
Dialogs are made up of a title, supporting text, and buttons:
When clients cancel out of a process, the dialogs asking them to confirm are handled a little bit differently. Follow this template:
These appear briefly after a user completes an action. Copy should mention the item involved in the action but not details about what the user changed, created, or added. Err on the side of the generic.
Write toasts in sentence case. No periods at the end unless there are two or more sentences (which there usually shouldn't be).
Whatever form an error message or alert may take — modal, toast, banner, etc. — follow these guidelines.
Be careful not to overuse this word. We don't need to ask the user to please perform common online actions, such as entering passwords or clicking a button.
When overused, "please" loses its meaning, taking up valuable UI space where useful copy could go. The greatest courtesy we can grant our users is concise language that lets them complete their tasks efficiently.
Enter your password is perfectly fine, but if you want to soften it a bit, express the value the user gets from a particular action: Enter your password to continue
Of course, we never want to sound abrupt. We aren't monsters! It's OK to use please in these situations:
If only two words would remain after removing "please," leave it in: Please try again.
In the case of a connection failure or outage, which leaves the user unable to do anything: Data currently unavailable. Please refresh the page or try again later.
In client emails when a polite touch is needed.
Unless the text is a question or contains more than one sentence, don't use punctuation in:
In general, don't use an ampersand in place of "and" except:
In common, accepted terms and navigation items: Transfers & Payments Confirmations & Prospectuses General & Regulatory
In common abbreviations. In these constructions, don't put spaces on either side of the ampersand. B&B R&D Q&A
When the ampersand is part of an organization's formal name. Follow the organization's style for spacing around the ampersand. H&R Block AT&T
Never use a comma before an ampersand.
Use periods in text that:
Use a comma after the second-to-last item in a series, before the conjunction ("and," "but," or "or").
It's username, one word. Not user name.
Always use sign in to refer to the action of entering credentials.
Use login (one word) as a noun or an adjective.
To avoid confusion with “sign in,” don’t use the phrase “sign up.” Instead, use “create an account” or similar phrases.
Contents