Brand voice and tone guidelines
Brand voice is the consistent personality a company shows in its words: the diction, rhythm, and attitude that make a sentence recognisably yours before anyone sees the logo. It holds steady while tone shifts with the moment, and keeping those two straight is the whole craft.
The idea that a brand has a personality predates the writing discipline, but the working separation of voice from tone is what made it usable for content teams. The clearest public articulation is Mailchimp's Content Style Guide, published openly so other teams could borrow it. Its formulation has become the reference point: the voice stays roughly the same from day to day; the tone changes all the time depending on the situation and the reader's emotional state.
Mailchimp defines its own voice as plainspoken, genuine, and a little dry-humoured, then shows the voice flexing into different tones across contexts. A celebratory tone when a user sends their first campaign. A plain, reassuring tone when a payment fails. Same personality, different register, chosen to match how the reader is feeling. That table of situations, each with a recommended tone, turned an abstract trait into something a writer can apply at three in the morning under deadline.
The practical instrument most teams adopt is the voice chart and its companion, the "we are / we are not" table. The voice chart lists each personality trait beside a do-this, avoid-that pair, so "confident" gets pinned down as "state things plainly" against "hedge and over-qualify." The "we are / we are not" table draws the boundary by contrast, naming the adjacent personality the brand keeps mistaking itself for. Without those guardrails, voice guidelines collapse into a list of flattering adjectives that no two writers interpret the same way.
A developer-tools company finds its docs, its changelogChangelogProduct SpecificationA record of changes shipped in a releaseView reference →, and its marketing site sound like three different companies. The docs are terse to the point of curt, the marketing is breathless, and the changelog is robotic. They write a voice chart with four traits: direct, technically precise, warm without being chummy, never condescending. Each trait carries a do/avoid pair and a real before-and-after rewrite pulled from their own copy.
The "we are not" column does the heavy lifting. "We are warm, we are not your buddy" kills the forced exclamation marks in marketing. "We are precise, we are not pedantic" stops the docs from explaining what a variable is. Tone still varies: an outage post-mortem is sober and specific, a featureFeatureProduct SpecificationA product capability or featureView reference → launch carries a little lift. The personality underneath stays fixed, so a reader moving from the marketing site into the docs feels one company instead of three.
In the Unified Product Graph, Brand VoiceBrand IdentityBrand voice and tone guidelines sits in the brand domain and connects upward to the identity it serves and outward to the words it shapes. The edge brand_voiceBrand Identityspeaks withBrand Voicehierarchy makes voice a defined facet of the brand's projected self, the verbal counterpart to colour and type. The edge brand_identity_speaks_with_brand_voiceMessagingaligns withBrand Voicecross-domain ties the abstract personality to concrete claims, so a positioningPositioningGo-To-MarketProduct positioning statementView reference → line or a campaign message can be checked against the voice that is meant to carry it. Holding voice as its own node, with its own edges, lets a team query every piece of messagingMessagingGo-To-MarketMessaging framework and key messagesView reference → that should conform to it and catch the surfaces, like a neglected changelog, that quietly drifted off. Buried as a property inside identity, voice would be far harder to audit that way.messaging_aligns_with_brand_voice
Type-specific fields on BaseNode
tone_attributesstring[]Tone descriptors defining how the brand sounds. @example ["confident", "warm", "precise", "never condescending"]
do_examplesstring[]Examples of correct brand voice. "This is how we write." @example ["We make complex things simple.", "Let's figure this out together."]
dont_examplesstring[]Examples to avoid. "We never write like this." @example ["Click here to leverage our synergies.", "Dear valued customer..."]
writing_principlesstring[]Core writing principles that govern all brand communication. @example ["Lead with clarity", "Be specific, not vague", "Write for humans first"]
vocabulary_preferencesstringPreferred and avoided vocabulary. @example "Say 'product creator', not 'entrepreneur'"
audience_adaptationstringHow voice adapts by audience segment. @example "Enterprise: more formal, data-led. Solo founders: conversational, encouraging."
channel_guidelinesstringVoice variation by communication channel. @example "Social: punchy and casual. Docs: precise and thorough. Email: warm and direct."
idstringrequiredUnique identifier (UUID)
typeNodeTyperequiredDiscriminator for the entity type
titlestringrequiredDisplay name
descriptionstringOptional detailed description
statusstringLifecycle status
tagsstring[]Freeform tags for filtering
4 phases — initial: draft · template: PUBLISHING
2 edge types connected to this entity.
brand_identity_speaks_with_brand_voicemessaging_aligns_with_brand_voice