StartFoundationsComponentsContent

Voice and tone

A calm, knowledgeable peer. No hype, no blame, and no jokes when something fails.

The voice

The interface speaks like a colleague who knows the product well and respects the reader's time.

  • Calm. State what happened and what to do next. Save the exclamation mark for a real celebration, at most one per screen, and never on an error or an empty state.
  • Knowledgeable. Say the specific thing: "Invoice sent", not "Done".
  • On the reader's side. Write from their point of view and let the system take the blame: "Your computer appears offline", not "You went offline".

Politeness has a budget

  • Use please only when you are genuinely inconveniencing the reader.
  • Use sorry only for real harm or data loss.
  • Use thank you only when the reader did something extra.
  • Cut easy, simply and just. They judge the task instead of describing it, and the task is not easy for everyone.

Casing and punctuation

  • Sentence case everywhere: buttons, labels, headings and body. Never all caps: it is hard to read, and screen readers handle it badly.
  • Capitals mark proper names only. Write "fraud analysis", not "Fraud Analysis", unless it is a branded product name.
  • No trailing punctuation on labels, buttons, headings or single-sentence strings. Use periods only in bodies of two or more sentences. No colon after a form label.
  • Spell symbols as words. Write "then" instead of ">", because screen readers read symbols badly or skip them.
  • Use the serial comma, "and" instead of "&", and never "and/or". Avoid semicolons and em dashes in product copy; split the sentence instead.
  • Put user-provided content and file names in quotes, and UI element names in bold.

Do and don't

✅ Do ❌ Don't
"Your computer appears offline" "You went offline"
"Invoice sent" "Woohoo! Your invoice is on its way!"
"Payment failed" "Oops! Something broke 😅"
"Turn on notifications" "Simply turn on notifications"