Skip to main content

Content

Writing and designing content in a thoughtful way makes your app usable, accessible, and readable.

Your written content's voice and tone help you talk to merchants in a consistent, recognizable way.

Voice refers to aspects of writing that are consistent across all contexts and audiences. Tone can change based on the audience and their current context.

Learn how to apply Shopify's voice and choose the right tone, no matter what app you're building, by referring to the Polaris guidelines on voice and tone.


The following are some principles behind writing product content for a quality merchant experience.

Shopify merchants are located all over the world, have varying levels of literacy, and might not speak English as their first language. Content can easily be mistranslated or misinterpreted.

Structure your content in a clear, efficient way.

To help merchants understand key concepts and actions, use terms in a consistent way.

One way to ensure consistency is to identify and eliminate synonyms for key concepts and actions.

Merchants use Shopify to get things done for their businesses. Write content that helps merchants understand and take the most important actions.

Anchor to Guide, don't prescribeGuide, don't prescribe

Write in a way that puts your merchant at the center and in control. Provide merchants with tools and knowledge for making the best decision.


Anchor to Grammar and mechanicsGrammar and mechanics

For spelling, punctuation, and other grammatical considerations, refer to the Polaris guidelines on grammar and mechanics.


Was this page helpful?