Content Design
Overview
How to write UI copy that serves users rather than impresses them. This section synthesizes patterns from production content design systems — MailChimp, Shopify Polaris, and industry writing practice — into principles that apply regardless of which design system or brand you're working in.
Content design is not copywriting and it is not visual design. It is the work of making words do their job in a UI context: communicating the right thing, in the right tone, at the right moment, with no more words than necessary.
Use these principles before writing any new UI copy, when auditing existing copy for consistency, or when establishing a voice guide for a new design system.
Articles
Sources
| Source | KB Path |
|---|---|
| MailChimp — Voice and Tone | kb/reference/design-systems/mailchimp/guidance/content/voice-and-tone |
| MailChimp — Grammar and Mechanics | kb/reference/design-systems/mailchimp/guidance/content/grammar-and-mechanics |
| MailChimp — Writing for Accessibility | kb/reference/design-systems/mailchimp/guidance/content/writing-for-accessibility |
| Shopify Polaris — Voice and Tone | kb/reference/design-systems/polaris/guidance/content/voice-and-tone |
| Shopify Polaris — Grammar and Mechanics | kb/reference/design-systems/polaris/guidance/content/grammar-and-mechanics |
| Shopify Polaris — Actionable Language | kb/reference/design-systems/polaris/guidance/content/actionable-language |
| Shopify Polaris — Error Messages | kb/reference/design-systems/polaris/guidance/content/error-messages |