Building a Brand Voice Document
A thorough voice reference covers the following areas. Use this structure to help teams articulate their voice from scratch or to interpret an existing voice configuration.
Brand Personality Profile
Describe the brand as though it were a human being. What character traits define it?
Example: "Our brand is the sharp-but-generous mentor — someone who breaks down hard ideas in plain language, takes genuine pride in your progress, and never condescends."
Communication Attributes (3-5)
Each attribute needs four elements to prevent ambiguity:
- A plain-language definition of what it means in practice
- A boundary statement explaining what it does NOT mean
- A sample sentence that embodies the attribute
- A sample sentence that violates the attribute
Target Audience Profile
- Primary and secondary audiences the brand addresses
- Core concerns and motivations of each audience
- Level of domain expertise to assume
- Communication expectations and preferences
Messaging Pillars (3-5)
- The recurring strategic themes the brand reinforces
- Relative priority among pillars (which leads in any given context)
- How each pillar maps to an audience need or pain point
Contextual Tone Range
How the voice flexes across situations while remaining unmistakably the same brand. See the Tone Modulation section below.
Editorial Style Rules
Concrete grammar, punctuation, and formatting standards. See Editorial Standards below.
Vocabulary Controls
Approved and prohibited terms. See Vocabulary Governance below.
Defining Communication Attributes
Attribute Spectrum Reference
Positioning attributes on a continuum helps teams calibrate. Common spectrums include:
| Dimension |
End A |
End B |
| Register |
Formal, institutional |
Relaxed, conversational |
| Expertise |
Authoritative, expert |
Collaborative, peer-level |
| Warmth |
Empathetic, personal |
Direct, no-nonsense |
| Technicality |
Precise, specialized |
Plain, universally accessible |
| Intensity |
Bold, high-energy |
Calm, understated |
| Levity |
Playful, witty |
Serious, measured |
| Orientation |
Forward-looking, innovative |
Established, reliability-focused |
Attribute Documentation Template
For every selected attribute, record:
[Attribute Name]
- In practice: [concrete behavioral description]
- Not to be confused with: [the common misinterpretation]
- Sounds like: [example sentence demonstrating it well]
- Does not sound like: [example sentence that crosses the line]
Example:
Welcoming
- In practice: inclusive, clear, free of jargon, equally respectful to newcomers and veterans
- Not to be confused with: oversimplified, excessively informal, or lacking depth
- Sounds like: "Getting set up takes about five minutes — here is how."
- Does not sound like: "Yo! Even a total beginner can figure this out lol."
Tone Modulation
The brand voice is the constant; tone is the variable that adjusts based on context. Tone represents the emotional calibration applied to the voice.
Tone by Communication Channel
| Channel |
Tone Shift |
Illustration |
| Blog |
Educational, conversational, exploratory |
"Here is a walkthrough of how this works and why your team should care." |
| LinkedIn |
Professional, thought-provoking, compact |
"Three takeaways from running 50 campaigns last quarter." |
| Twitter/X |
Sharp, concise, occasionally playful |
"Your landing page gets 3 seconds. Spend them wisely." |
| Email marketing |
Personal, supportive, action-oriented |
"We built something we think will save you real time." |
| Sales materials |
Assured, benefit-focused, evidence-backed |
"Teams on our platform cut reporting overhead by 40%." |
| Help documentation |
Patient, sequential, unambiguous |
"If this error appears, follow these steps to resolve it." |
| Press releases |
Formal, factual, newsworthy |
"The company announced today the general availability of..." |
| Error states |
Understanding, constructive, non-blaming |
"We hit a snag on our side. Our team is already investigating." |
Tone by Scenario
| Scenario |
Tone Adjustment |
| Product launch |
Confident, enthusiastic, forward-looking |
| Service disruption |
Transparent, accountable, empathetic |
| Customer win |
Celebratory, specific, customer-centered |
| Industry thought leadership |
Nuanced, evidence-driven, authoritative |
| New user onboarding |
Encouraging, clear, welcoming |
| Unwelcome news (price changes, deprecations) |
Honest, respectful, solution-focused |
| Competitive positioning |
Self-assured, factual, never disparaging |
The Dial Principle
Voice attributes remain constant. Tone turns their intensity up or down depending on the moment. For a brand that is "confident and warm":
- At a product launch, confidence takes the lead
- During an outage, warmth takes the lead
- Neither quality vanishes; the emphasis shifts
Editorial Standards
Grammar and Mechanical Choices
Consistency matters more than any single choice. Document and enforce these decisions:
| Decision |
Alternatives |
Sample |
| Serial comma |
Include / Omit |
"fast, reliable, and secure" vs. "fast, reliable and secure" |
| Heading capitalization |
Sentence case / Title case |
"How to get started" vs. "How to Get Started" |
| Contractions |
Permit / Avoid |
"we're" vs. "we are" |
| Em dash style |
No surrounding spaces / Spaces |
"this—and more" vs. "this — and more" |
| Numeral rules |
Spell out one through nine / Always use digits |
"five features" vs. "5 features" |
| Percentage notation |
Symbol / Word |
"50%" vs. "50 percent" |
| Date styling |
Month DD, YYYY / DD/MM/YYYY / other |
"January 15, 2025" |
| Time styling |
12-hour / 24-hour |
"3:00 PM" vs. "15:00" |
| List punctuation |
Terminal periods / No periods on fragments |
"Set up your account." vs. "Set up your account" |
Formatting Conventions
- Heading hierarchy rules (when H1, H2, H3 are appropriate)
- Bold vs. italic purpose (bold for emphasis, italic for titles or introducing terms)
- Hyperlink text standards (always descriptive; never "click here")
- Image alt text requirements
- Code formatting norms (for technical brands)
- Use of callout or highlight boxes
Punctuation and Emphasis Policies
- Exclamation marks: use sparingly, never consecutively
- Ellipses: avoid in professional content
- All-caps: prohibited for emphasis; use bold instead
- Emoji: prohibited in professional channels; acceptable in social where context warrants
Vocabulary Governance
Standardized Terms
Maintain an authoritative list of correct forms alongside common mistakes:
| Approved Form |
Incorrect Form |
Rationale |
| sign up (verb) |
signup (verb) |
"signup" is the noun/adjective form |
| log in (verb) |
login (verb) |
"login" is the noun/adjective form |
| set up (verb) |
setup (verb) |
"setup" is the noun/adjective form |
| email |
e-mail |
No hyphen; industry standard |
| website |
web site |
Single word; modern convention |
| data is (singular) |
data are |
Unless publication style mandates plural |
Product and Feature Naming
- Canonical capitalization for every product name
- Rules for when to use the full name vs. an abbreviated form
- Whether "the" precedes product names
- How version numbers appear in copy
- Trademark and registration symbol usage (where required and where to omit)
Language Inclusivity
- Default to gender-neutral pronouns (they/them for individuals of unknown gender)
- Eliminate ableist expressions ("crazy", "blind spot", "lame")
- Favor person-first phrasing where relevant
- Steer clear of culturally-bound idioms that resist translation
- Prefer "straightforward" or "simple" over "easy" — difficulty is subjective
Technical and Industry Terminology
- Catalogue which specialized terms the audience grasps without explanation
- Identify jargon that must always be defined or replaced with plain language
- Specify which acronyms require full expansion on first use
- Build an audience-segmented glossary for terms with different meanings across reader groups
Competitive and Market Language
- Define your preferred framing for your product category
- Establish how competitors are referenced (by name or generically)
- Identify competitor-coined terms to avoid, so you do not reinforce rival positioning
- Codify your preferred differentiation phrasing
1---
2name: brand-guidelines
3description: Define or enforce brand voice, messaging, terminology, tone, and style standards.
4metadata:
5 source: https://skillmd.com/skills/vm0-ai/brand-guidelines
6---
7
8## Building a Brand Voice Document
9
10A thorough voice reference covers the following areas. Use this structure to help teams articulate their voice from scratch or to interpret an existing voice configuration.
11
12### Brand Personality Profile
13Describe the brand as though it were a human being. What character traits define it?
14
15Example: "Our brand is the sharp-but-generous mentor — someone who breaks down hard ideas in plain language, takes genuine pride in your progress, and never condescends."
16
17### Communication Attributes (3-5)
18Each attribute needs four elements to prevent ambiguity:
19- A plain-language definition of what it means in practice
20- A boundary statement explaining what it does NOT mean
21- A sample sentence that embodies the attribute
22- A sample sentence that violates the attribute
23
24### Target Audience Profile
25- Primary and secondary audiences the brand addresses
26- Core concerns and motivations of each audience
27- Level of domain expertise to assume
28- Communication expectations and preferences
29
30### Messaging Pillars (3-5)
31- The recurring strategic themes the brand reinforces
32- Relative priority among pillars (which leads in any given context)
33- How each pillar maps to an audience need or pain point
34
35### Contextual Tone Range
36How the voice flexes across situations while remaining unmistakably the same brand. See the Tone Modulation section below.
37
38### Editorial Style Rules
39Concrete grammar, punctuation, and formatting standards. See Editorial Standards below.
40
41### Vocabulary Controls
42Approved and prohibited terms. See Vocabulary Governance below.
43
44## Defining Communication Attributes
45
46### Attribute Spectrum Reference
47
48Positioning attributes on a continuum helps teams calibrate. Common spectrums include:
49
50| Dimension | End A | End B |
51|-----------|-------|-------|
52| Register | Formal, institutional | Relaxed, conversational |
53| Expertise | Authoritative, expert | Collaborative, peer-level |
54| Warmth | Empathetic, personal | Direct, no-nonsense |
55| Technicality | Precise, specialized | Plain, universally accessible |
56| Intensity | Bold, high-energy | Calm, understated |
57| Levity | Playful, witty | Serious, measured |
58| Orientation | Forward-looking, innovative | Established, reliability-focused |
59
60### Attribute Documentation Template
61
62For every selected attribute, record:
63
64**[Attribute Name]**
65- **In practice**: [concrete behavioral description]
66- **Not to be confused with**: [the common misinterpretation]
67- **Sounds like**: [example sentence demonstrating it well]
68- **Does not sound like**: [example sentence that crosses the line]
69
70Example:
71
72**Welcoming**
73- **In practice**: inclusive, clear, free of jargon, equally respectful to newcomers and veterans
74- **Not to be confused with**: oversimplified, excessively informal, or lacking depth
75- **Sounds like**: "Getting set up takes about five minutes — here is how."
76- **Does not sound like**: "Yo! Even a total beginner can figure this out lol."
77
78## Tone Modulation
79
80The brand voice is the constant; tone is the variable that adjusts based on context. Tone represents the emotional calibration applied to the voice.
81
82### Tone by Communication Channel
83
84| Channel | Tone Shift | Illustration |
85|---------|-----------|-------------|
86| Blog | Educational, conversational, exploratory | "Here is a walkthrough of how this works and why your team should care." |
87| LinkedIn | Professional, thought-provoking, compact | "Three takeaways from running 50 campaigns last quarter." |
88| Twitter/X | Sharp, concise, occasionally playful | "Your landing page gets 3 seconds. Spend them wisely." |
89| Email marketing | Personal, supportive, action-oriented | "We built something we think will save you real time." |
90| Sales materials | Assured, benefit-focused, evidence-backed | "Teams on our platform cut reporting overhead by 40%." |
91| Help documentation | Patient, sequential, unambiguous | "If this error appears, follow these steps to resolve it." |
92| Press releases | Formal, factual, newsworthy | "The company announced today the general availability of..." |
93| Error states | Understanding, constructive, non-blaming | "We hit a snag on our side. Our team is already investigating." |
94
95### Tone by Scenario
96
97| Scenario | Tone Adjustment |
98|----------|----------------|
99| Product launch | Confident, enthusiastic, forward-looking |
100| Service disruption | Transparent, accountable, empathetic |
101| Customer win | Celebratory, specific, customer-centered |
102| Industry thought leadership | Nuanced, evidence-driven, authoritative |
103| New user onboarding | Encouraging, clear, welcoming |
104| Unwelcome news (price changes, deprecations) | Honest, respectful, solution-focused |
105| Competitive positioning | Self-assured, factual, never disparaging |
106
107### The Dial Principle
108Voice attributes remain constant. Tone turns their intensity up or down depending on the moment. For a brand that is "confident and warm":
109- At a product launch, confidence takes the lead
110- During an outage, warmth takes the lead
111- Neither quality vanishes; the emphasis shifts
112
113## Editorial Standards
114
115### Grammar and Mechanical Choices
116
117Consistency matters more than any single choice. Document and enforce these decisions:
118
119| Decision | Alternatives | Sample |
120|----------|-------------|--------|
121| Serial comma | Include / Omit | "fast, reliable, and secure" vs. "fast, reliable and secure" |
122| Heading capitalization | Sentence case / Title case | "How to get started" vs. "How to Get Started" |
123| Contractions | Permit / Avoid | "we're" vs. "we are" |
124| Em dash style | No surrounding spaces / Spaces | "this—and more" vs. "this — and more" |
125| Numeral rules | Spell out one through nine / Always use digits | "five features" vs. "5 features" |
126| Percentage notation | Symbol / Word | "50%" vs. "50 percent" |
127| Date styling | Month DD, YYYY / DD/MM/YYYY / other | "January 15, 2025" |
128| Time styling | 12-hour / 24-hour | "3:00 PM" vs. "15:00" |
129| List punctuation | Terminal periods / No periods on fragments | "Set up your account." vs. "Set up your account" |
130
131### Formatting Conventions
132- Heading hierarchy rules (when H1, H2, H3 are appropriate)
133- Bold vs. italic purpose (bold for emphasis, italic for titles or introducing terms)
134- Hyperlink text standards (always descriptive; never "click here")
135- Image alt text requirements
136- Code formatting norms (for technical brands)
137- Use of callout or highlight boxes
138
139### Punctuation and Emphasis Policies
140- Exclamation marks: use sparingly, never consecutively
141- Ellipses: avoid in professional content
142- All-caps: prohibited for emphasis; use bold instead
143- Emoji: prohibited in professional channels; acceptable in social where context warrants
144
145## Vocabulary Governance
146
147### Standardized Terms
148
149Maintain an authoritative list of correct forms alongside common mistakes:
150
151| Approved Form | Incorrect Form | Rationale |
152|--------------|---------------|-----------|
153| sign up (verb) | signup (verb) | "signup" is the noun/adjective form |
154| log in (verb) | login (verb) | "login" is the noun/adjective form |
155| set up (verb) | setup (verb) | "setup" is the noun/adjective form |
156| email | e-mail | No hyphen; industry standard |
157| website | web site | Single word; modern convention |
158| data is (singular) | data are | Unless publication style mandates plural |
159
160### Product and Feature Naming
161- Canonical capitalization for every product name
162- Rules for when to use the full name vs. an abbreviated form
163- Whether "the" precedes product names
164- How version numbers appear in copy
165- Trademark and registration symbol usage (where required and where to omit)
166
167### Language Inclusivity
168- Default to gender-neutral pronouns (they/them for individuals of unknown gender)
169- Eliminate ableist expressions ("crazy", "blind spot", "lame")
170- Favor person-first phrasing where relevant
171- Steer clear of culturally-bound idioms that resist translation
172- Prefer "straightforward" or "simple" over "easy" — difficulty is subjective
173
174### Technical and Industry Terminology
175- Catalogue which specialized terms the audience grasps without explanation
176- Identify jargon that must always be defined or replaced with plain language
177- Specify which acronyms require full expansion on first use
178- Build an audience-segmented glossary for terms with different meanings across reader groups
179
180### Competitive and Market Language
181- Define your preferred framing for your product category
182- Establish how competitors are referenced (by name or generically)
183- Identify competitor-coined terms to avoid, so you do not reinforce rival positioning
184- Codify your preferred differentiation phrasing