Brand Settings Guide

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
• Brand Skills - Procedural playbooks the AI follows (Power+)
• AI Instructions - Custom rules for content generation
• GSC Connection - Google Search Console integration
• GA4 Connection - Google Analytics 4 integration (Solo+)
• Bing Webmaster Connection - Bing search analytics integration (Solo+)

💡 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:

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

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.

Delete a Brand

You can delete any brand yourself from the in-app settings. No need to email support.

Steps:

1. Switch to the brand you want to delete (top-left brand switcher)
2. Go to Brand Settings → Basic Details
3. Scroll to the bottom - you’ll see a red Danger Zone card titled Delete Brand
4. Click Delete [your-domain.com]
5. In the confirmation modal, type the full domain (exactly as shown) to enable the Yes, Delete button
6. Click Yes, Delete

What gets removed:

• All site settings, brand voice, AI instructions, and knowledge sources
• All articles, drafts, and projects associated with this brand
• All keywords, content planner items, and integrations
• All link engine data and analytics

Important:

• This is irreversible - there is no undo and no recovery
• Deletion runs in the background and can take a few minutes for brands with lots of content
• You must be a team admin or owner to delete a brand
• Rate-limited to 5 deletions per day per team
• Your subscription seat count is not affected (sites and seats are separate)

⚠️ If you only want to pause a brand temporarily rather than delete it, contact support - there’s no built-in “archive” yet, but support can disable a brand without deleting its data.

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

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

Knowledge Sources vs Brand Voice

Brand Skills

Brand Skills are procedural playbooks (SKILL.md files) that teach the AI how to perform tasks for your brand. Where Knowledge Sources give the AI facts, Skills give it repeatable methods: your SEO audit checklist, your social posting formula, your editorial review process.

Plan: Power and higher.

How Skills Differ From Knowledge Sources

Adding Skills

In Brand Settings → Skills, add skills three ways:

• Import from GitHub - paste a repo URL or owner/repo; Cuppa discovers every SKILL.md, previews them, and pins each to the exact commit it imported.
• Upload a zip - bundle one or more skill folders; safety-scanned on import.
• Create manually - enter a name, description, and markdown body.

How Skills Are Applied

Active skills are matched against each generation task (by name and description) and injected across every surface: articles, social, newsletters, carousels, pages, the editor, Workbench, and Agentic Chat. You can also attach specific skills to an AI Instructions preset to force their use.

Skills are treated as untrusted input: content is stored as an immutable snapshot, scanned for prompt-injection patterns, and wrapped so it complements (never overrides) Cuppa’s system instructions. Only team admins can import or create skills.

See the full Brand Skills guide for details.

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

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

GA4 Connection

Connect Google Analytics 4 per brand for on-site traffic in Performance Hub.

Plan: Solo and higher (same as GSC).

What GA4 Connection Enables

How to Connect

1. Connect GA4 at Team Settings → Integrations first (one OAuth per team)
2. Go to Brand Settings → Basic
3. In Google Analytics 4, select your team connection
4. Choose the GA4 property for this brand
5. Save

See Google Analytics 4 for full setup and troubleshooting.

Bing Webmaster Connection

Connect Bing Webmaster Tools per brand to include Bing search data in Performance Hub and Brand Visibility Score.

Plan: Solo and higher (same as GSC). Requires NEXT_PUBLIC_BING_WMT_ENABLED=true in the Cuppa environment.

What Bing Connection Enables

How to Connect

1. Connect Bing at Team Settings → Integrations first (one OAuth per team)
2. Go to Brand Settings → Basic
3. In Bing Webmaster Tools, select your team connection
4. Choose the verified Bing property for this brand
5. Save (triggers immediate sync)

See Bing Webmaster Tools for full setup and troubleshooting.

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
• Connect GA4 if available (Solo+)
• Connect Bing Webmaster if available (Solo+)
• Add any critical Knowledge Sources

Ongoing Maintenance

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.

Do settings affect existing content?

No. Settings only affect newly generated content. Existing articles remain unchanged.

What if my brand has multiple distinct voices?

Create separate “sites” in Cuppa for each distinct voice (e.g., main blog vs. developer docs).

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.

How do I delete a brand?

Self-serve from Brand Settings → Basic Details → Delete Brand (red Danger Zone card at the bottom). Type the domain to confirm. See the Delete a Brand section above for full details. You do not need to email support for this.

How do I delete extra brands created during my free trial?

Same self-serve flow as above. Switch into each unwanted brand, go to Brand Settings → Basic Details, scroll to the bottom, and click Delete Brand. Repeat for each one. There is no bulk delete, but each deletion takes about 10 seconds to initiate.

Can I delete the only/last brand on my account?

Yes, but you’ll need to add a new brand afterward to use Cuppa. If you want to cancel your account entirely instead, see Organization Settings.

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: support@cuppa.ai
• 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!