Titles
Purpose: Orient users to where they are Format: Noun phrases, sentence case Types:- Brand titles (“Settings”, “Dashboard”)
- Content titles (“Your library”, “Recent orders”)
- Category titles (“Account”, “Privacy”)
- Task titles (“Create new post”, “Edit profile”)
Examples
Buttons and links
Purpose: Enable users to take action Format: Active imperative verbs, sentence case Pattern:[Verb] [object]
Examples
Button length targets
- Ideal: 2-4 words
- Maximum: 6 words
- Character count: 15-25 characters
Error messages
Purpose: Explain problem and provide solution Format: Empathetic, clear, actionable Pattern:[What failed]. [Why/context]. [What to do].
Error messages adapt based on type and severity:
Validation errors (inline)
Validation errors (inline)
When to use: Show as user completes field or on blurPattern:
[Field] [specific requirement]Examples:- “Email must include @”
- “Password must be at least 8 characters”
- “Choose a date in the future”
System errors (modal/banner)
System errors (modal/banner)
Blocking errors (full-screen)
Blocking errors (full-screen)
When to use: Prevent continued use until resolvedPattern:
[What's blocked]. [Why]. [Specific action needed].Examples:- “Update required. This version is no longer supported. Update now to continue.”
- “Subscription expired. Your account is paused. Renew subscription to restore access.”
- “Verification needed. Confirm your email to access features. Check your inbox.”
Permission errors
Permission errors
When to use: When requesting device permissionsPattern:
[User benefit]. [Permission needed].Examples:- “Get notified when orders ship. Enable notifications.”
- “Find nearby stores. Allow location access.”
- “Back up your photos. Grant storage permission.”
What to avoid in error messages
Success messages
Purpose: Confirm action completion Format: Past tense, specific, encouraging Pattern:[Action] [result/benefit]
Examples
Length targets
- Simple actions: 2-3 words (“Changes saved”)
- Complex actions: 4-6 words (“Profile updated. Your changes are live.”)
- Maximum: 10-15 words total
Empty states
Purpose: Guide users when content is absent Types:- First-use (never had content)
- User-cleared (user removed all content)
- Error/no results (search or filter returned nothing)
Examples
Empty states should always include a clear next action. Don’t leave users stuck.
Structure
- Headline: Explain why it’s empty (3-6 words)
- Description: Provide context (8-12 words)
- CTA: Clear action to populate (2-4 words)
Form fields
Form fields need multiple text elements working together:Labels
Labels
Purpose: Describe what input is neededFormat: Clear noun phrasesExamples:
- “Email address”
- “Phone number”
- “Date of birth”
- Always visible (not hidden as placeholder)
- Sentence case
- No punctuation at end
Instructions
Instructions
Purpose: Explain why information is needed or how to format itFormat: Verb-first, clear purposeExamples:
- “We’ll use this to contact you about your order”
- “Choose a password with at least 8 characters”
- “Enter your code in the format: XXX-XXX-XXX”
- Static (always visible) for important requirements
- On-demand (tooltip/help icon) for optional context
Placeholder text
Placeholder text
Purpose: Show format example for standard inputsFormat: Example, not instructionExamples:
- “name@example.com”
- “555-123-4567”
- “MM/DD/YYYY”
- Use sparingly
- Never replace labels
- Only for standard, recognizable formats
Helper text
Helper text
Purpose: Provide additional guidance or constraintsFormat: Brief, specificExamples:
- “Maximum 160 characters”
- “Only letters and numbers allowed”
- “This will be visible to other users”
- Static for important information
- Dynamic (on focus) for helpful hints
Notifications
Purpose: Deliver timely, valuable information Types:- Action-required (intrusive, demands attention)
- Passive (less intrusive, informational)
Examples
Structure
- Title: Action or event (3-6 words)
- Body: Context and details (8-12 words)
- CTA: Optional action button (2-4 words)
Length targets
- Title: 35-45 characters
- Body: 10-15 words
- Total: 15-20 words maximum