Shopify Polaris — Voice and Tone

Core philosophy

Shopify's content approach treats words as essential design material, not labels added after design is done. The guiding principle: "Very few interfaces make sense without content. But each word and every period adds noise to the experience."

This framing has a practical consequence: content is never decorative. Every word added must justify its presence. Every word removed that does not reduce clarity should be removed.

The five content principles

1. Content and design work together

Content is not a layer applied after design — it is integral to it. Not every designed component requires all available content options. "Only add content that's necessary for clarity. Let visuals and icons do the talking wherever you can."

In practice: Don't add a label if an icon is sufficient and recognizable. Don't add helper text if the label is already specific enough.

2. Keep it lean

Minimize content to avoid the UI appearing cheap or confusing. "Find the shortest, clearest way to give merchants only the info they need." Eliminate repetition. Skip punctuation except for questions or text with two or more sentences.

In practice: If a button, heading, and surrounding UI already communicate what an action does, the button label can be shorter. "+" is sufficient in context where "Add product" would be redundant.

3. Write like merchants talk

Prioritize human-sounding language over formal writing conventions. Use contractions ("don't" not "do not"). Incorporate merchant-relevant jargon where appropriate — merchants know what "SKU," "fulfillment," and "chargeback" mean; avoid these terms only when the audience may not. Aim for a 7th-grade reading level — "it's easiest for merchants to digest."

The test: Read the copy aloud. Does it sound like something a person would actually say?

4. Inspire action

"Focus on the one thing merchants need to know or do next." Use verbs to open sentences — "Start sentences with verbs so they feel like actionable instructions." Be direct. Use design hierarchy (size, weight, placement) to signal importance rather than piling emphasis into the words themselves.

Break complex tasks into digestible steps rather than front-loading all information.

5. Merchant-centered approach

All content should serve the merchant's clarity and confidence. The question is always: does this help the merchant understand what to do? Does this give them the confidence to do it?

Address merchants as "you"

Refer to the merchant as "you." Refer to Shopify as "we." Do not use "the user" or third-person framing in UI copy.

Tone

Tone follows the merchant's emotional state in context. Voice (the character behind the writing) stays constant; tone (the register used in a specific moment) adjusts:

During setup and onboarding: warm, encouraging, guiding
During normal task flow: neutral and efficient — the copy should be invisible
During errors: direct, calm, solution-focused — no cheerfulness
During destructive actions: clear and specific — the merchant needs facts, not reassurance

Voice And Tone