# Brand Settings Dashboard Your Brand Settings in Cuppa define how AI understands and represents your business across all generated content. This guide covers every setting and how it impacts your content quality. ### Overview Brand Settings are organized into several sections: * **Brand Voice** - Your unique writing style and tone * **Basic Details** - Category, language, and region * **Site Summary** - What your brand is about * **Knowledge Sources** - Additional context for AI * **AI Instructions** - Custom rules for content generation * **GSC Connection** - Google Search Console integration > 💡 **Pro tip**: Settings marked as "auto-populated" come from Brand DNA extraction during onboarding. You can always refine them manually. *** ### Brand Voice Brand 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 #### Example Prompt Injection When you have Brand Voice configured, this context is added to AI prompts: ``` ## Brand Voice Guidelines: Persona: """ An experienced SaaS founder who has built and scaled multiple companies. Speaks with authority but remains approachable. """ Tone: Professional yet conversational Formality: Business casual - avoids stuffy corporate speak Vocabulary Style: """ Uses industry terms when necessary but always explains them. Prefers actionable language over abstract concepts. """ Sentence Structure: """ Varies between short punchy sentences and longer explanatory ones. Uses questions to engage readers. Favors active voice. """ ``` *** ### Basic Details These settings help AI understand your brand context and target market. #### Category Your primary business category affects: * Content tone suggestions * Industry-specific terminology * Relevant examples and analogies Available categories include: Technology, Finance, Healthcare, E-commerce, Education, Marketing, and more. #### Default Language Sets the primary language for: * All generated content * UI suggestions and defaults * Keyword research (when applicable) #### Default Country/Region Influences: * Localized spelling (US vs UK English) * Regional references and examples * Currency and measurement preferences * Cultural context in content > 💡 You can override language and region per-article during generation. *** ### Site Summary Two key fields that give AI essential context about your brand: #### Website Overview A 2-4 sentence description of what your website/business does. **Good example:** > "Cuppa is an AI-powered content platform for SEO professionals and content marketers. We help teams create high-quality, on-brand articles at scale using intelligent automation and brand-aware AI." **Poor example:** > "We make content." #### Target Audience Describe who you're writing for. Be specific about: * Job titles/roles * Pain points * Experience level * Goals they're trying to achieve **Good example:** > "Content marketing managers at B2B SaaS companies with 50-500 employees. They need to produce 10-20 blog posts per month but have limited writer bandwidth. They care about SEO performance and brand consistency." **Poor example:** > "Everyone who needs content." #### How Site Summary Impacts Content | Field | Impact on Generated Content | | -------------------- | --------------------------------------------------------------------------- | | **Website Overview** | Sets context for topic relevance, ensures content aligns with your business | | **Target Audience** | Adjusts complexity level, examples used, problems addressed | *** ### Knowledge Sources Knowledge Sources provide additional context beyond your core brand settings. #### What Are Knowledge Sources? Supplementary information you provide to help AI generate more accurate, relevant content: * **Documents** - PDFs, Word docs, internal guides * **URLs** - Reference pages, documentation, product pages * **Text Snippets** - Key facts, statistics, company info #### When to Use Knowledge Sources | Use Case | Type | Example | | --------------- | ------------ | ---------------------------------------- | | Product details | Document/URL | Product spec sheets, feature lists | | Company facts | Text | Founding date, employee count, locations | | Style guides | Document | Internal brand guidelines | | Research | URL | Industry reports, studies you cite often | | FAQs | Text | Common questions and approved answers | #### Knowledge Sources vs Brand Voice | Feature | Brand Voice | Knowledge Sources | | ----------- | ------------------------ | ------------------------ | | **Purpose** | How you write | What you know | | **Affects** | Tone, style, vocabulary | Facts, details, accuracy | | **Input** | Sample content | Documents, URLs, facts | | **Output** | Writing style guidelines | Contextual knowledge | *** ### AI Instructions Custom rules that override or supplement default AI behavior. #### Site-Level Instructions Apply to all content generated for this site: ``` Always include a TL;DR section at the top of articles. Never use the word "utilize" - prefer "use" instead. Include at least one data point or statistic per major section. End articles with a clear call-to-action. ``` #### Per-Article Instructions Can be added during article generation for one-off requirements: ``` This article is for our developer audience - be more technical. Include code examples where relevant. Reference our API documentation at docs.example.com. ``` #### Instruction Priority When instructions conflict, this is the precedence order: 1. **Per-article instructions** (highest priority) 2. **Site-level AI Instructions** 3. **Brand Voice guidelines** 4. **Default Cuppa behavior** (lowest priority) *** ### GSC Connection Connect Google Search Console to enhance your content strategy. #### What GSC Connection Enables | Feature | Description | | ----------------------- | ------------------------------------------------- | | **Keyword insights** | See what you're actually ranking for | | **Click data** | Understand which content performs | | **Impression data** | Identify ranking opportunities | | **Content suggestions** | AI-powered recommendations based on your GSC data | #### How to Connect 1. Go to **Brand Details** tab in Settings 2. Click **Connect Google Search Console** 3. Authorize Cuppa to access your GSC data 4. Select the property to connect #### Privacy & Security * Cuppa only requests read-only access * We never modify your GSC settings * Data is used solely for content recommendations * You can disconnect at any time *** ### Best Practices #### Initial Setup Checklist * [ ] Create Brand Voice with 3-5 quality examples * [ ] Fill in Website Overview (2-4 sentences) * [ ] Define Target Audience specifically * [ ] Set correct language and region * [ ] Choose appropriate category * [ ] Connect GSC if available * [ ] Add any critical Knowledge Sources #### Ongoing Maintenance | Task | Frequency | Why | | ------------------------- | ------------------- | ---------------------------- | | Review Brand Voice | Quarterly | Update if your style evolves | | Update Target Audience | When market changes | Keep content relevant | | Refresh Knowledge Sources | As products change | Ensure accuracy | | Check AI Instructions | Monthly | Remove outdated rules | #### Common Mistakes to Avoid 1. **Too vague target audience** - "Everyone" isn't helpful 2. **Inconsistent Brand Voice examples** - Pick content that sounds like YOU 3. **Outdated Website Overview** - Update after pivots or rebranding 4. **Too many AI Instructions** - Keep them focused and essential 5. **Ignoring regional settings** - US vs UK English matters *** ### Frequently Asked Questions #### How long does Brand Voice take to create? Usually 1-3 minutes. The AI analyzes your examples and extracts voice guidelines automatically. #### Can I have multiple Brand Voices? Currently one active Brand Voice per site. You can create a new one to replace the current voice. If you need more, we can help you add in extra prompting. #### Can I delete a site that I've connected? Yes, in brand settings tab at the bottom, you can delete a connection to a site. Just to be warned, when you delete the site, everything is deleted: Content plan, brand info, brand dna, etc. Give it up to 5 minutes to delete (we have a lot of data generally per brand). #### Do settings affect existing content? No. Settings only affect newly generated content. Existing articles remain unchanged. #### How do I know if my settings are working? Generate a test article and review it for: * Correct tone and formality * Appropriate audience targeting * Accurate brand references #### Can I export my Brand Voice settings? Not currently, but this is on our roadmap. *** ### Troubleshooting #### Brand Voice Not Reflecting in Content 1. Ensure Brand Voice is set to **Active** 2. Check if you have conflicting AI Instructions 3. Try regenerating with "Use Brand Voice" explicitly enabled #### GSC Not Syncing 1. Verify property is correctly selected 2. Check your GSC access permissions 3. Allow 24-48 hours for initial data sync #### Content Too Generic Despite Settings 1. Review Website Overview - make it more specific 2. Add Knowledge Sources with key differentiators 3. Include specific AI Instructions about your unique angle *** ### Need Help? * **Email**: * **Documentation**: learn.cuppa.ai * **In-app Chat**: Available in the bottom-right corner We're happy to help you optimize your brand settings for the best content output! --- # 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-settings-dashboard.md?ask= ``` 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.