# Brand Voice

GoBrand Voice is the most powerful setting for content consistency. It teaches AI to write exactly like you.

**What It Does**

When you create a Brand Voice, Cuppa analyzes your sample content to extract:

| Component              | Description                                 | Example                                                         |
| ---------------------- | ------------------------------------------- | --------------------------------------------------------------- |
| **Persona**            | The character/role your content speaks from | "Experienced content marketer who values data-driven decisions" |
| **Tone**               | The emotional quality of your writing       | Professional, approachable, witty, authoritative                |
| **Formality**          | How formal or casual your content is        | Conversational but professional                                 |
| **Vocabulary Style**   | Word choice patterns                        | Uses industry jargon sparingly, prefers simple explanations     |
| **Sentence Structure** | Writing rhythm and patterns                 | Varies sentence length, uses bullet points for lists            |

**How to Create a Great Brand Voice**

1. **Choose representative content** - Pick 3-5 pieces that truly represent your best writing
2. **Use longer samples** - 500+ word articles work better than short snippets
3. **Include variety** - Blog posts, how-tos, and thought leadership pieces
4. **Avoid guest content** - Only use content you or your team actually wrote

**What Makes Good Examples**

| ✅ Good Examples               | ❌ Poor Examples                    |
| ----------------------------- | ---------------------------------- |
| Your original blog posts      | Guest contributor articles         |
| Content you're proud of       | Heavily edited/ghostwritten pieces |
| Representative of your voice  | One-off experimental content       |
| 500+ words                    | Short social media posts           |
| Recent content (last 2 years) | Outdated content from years ago    |

**Adding Examples**

You can provide examples in two ways:**Paste Text**: Copy and paste the full content directly

* Best for: Content not published online, internal docs
* Preserves formatting

**Add URLs**: Provide links to published content

* Best for: Live blog posts, published articles
* Cuppa scrapes the content automatically
* URL must be publicly accessible

**When Brand Voice Is Applied**

Brand Voice guidelines are injected into every content generation request:

* ✅ Article generation (all types)
* ✅ Outline generation
* ✅ Local news articles
* ✅ Content rewrites
* ❌ Keyword clustering (no text generation)
* ❌ SERP analysis 

<figure><img src="/files/pH2ZwLA3hSxjLTkkU55O" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.cuppa.ai/brand-dna/brand-voice.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.