> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revbridge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Brand Elements

> Configure your brand identity for AI-powered template generation

Brand Elements define your visual identity and brand voice. RevBridge AI uses this information to generate templates that match your brand automatically.

## Overview

Access Brand Elements from **Assets → Branding** in the sidebar. Here you manage your:

* Brand Dossier (comprehensive brand profile)
* Color palettes
* Typography settings
* Logos and imagery
* Brand voice guidelines

## Brand Dossier

A **Brand Dossier** is RevBridge AI's complete understanding of your brand. It powers AI template generation.

### Creating a Brand Dossier

<Steps>
  <Step title="Enter Your Website URL">
    Provide your main website URL (e.g., [https://yourstore.com](https://yourstore.com))
  </Step>

  <Step title="Start Brand Scan">
    Click **Scan Brand** to begin AI analysis
  </Step>

  <Step title="Wait for Processing">
    The AI crawls your site through multiple stages: crawling pages, processing assets, analyzing colors, and generating insights. A live progress indicator shows the current stage and percentage (1-3 minutes total)
  </Step>

  <Step title="Review Results">
    Review the extracted brand information
  </Step>

  <Step title="Refine and Save">
    Make adjustments and save your Brand Dossier
  </Step>
</Steps>

<Info>
  The Brand Intelligence system visits multiple pages on your site to build a comprehensive picture of your brand identity. If your site uses bot protection (e.g., Cloudflare), the scan may take longer or require manual adjustments.
</Info>

### Brand Dossier and Campaigns

A completed Brand Dossier is a **hard prerequisite** for launching any AI Campaign. Without it, campaign launch is blocked with an error message directing you to set up your brand first.

When you launch a campaign, the system always uses the **latest completed Brand Dossier** — not the one that existed when the campaign was created. This means:

* If you re-run brand discovery and update your dossier, all subsequent campaign launches automatically use the new brand identity
* A dossier in "pending" or "failed" status does not satisfy the requirement — only completed dossiers count
* AI-generated campaign content is always grounded in your current brand

### What Gets Extracted

The AI analyzes your website to identify:

| Element              | Description                          |
| -------------------- | ------------------------------------ |
| **Primary Color**    | Your main brand color                |
| **Secondary Colors** | Supporting colors in your palette    |
| **Accent Colors**    | Colors used for highlights and CTAs  |
| **Neutral Colors**   | Background and text colors           |
| **Typography**       | Font families and hierarchy          |
| **Logo**             | Primary logo (extracted or uploaded) |
| **Visual Style**     | Photography and imagery approach     |
| **Brand Voice**      | Tone and communication style         |

## Color Palette

Your color palette drives the visual appearance of generated templates.

### Color Categories

| Category      | Purpose                | Example Use            |
| ------------- | ---------------------- | ---------------------- |
| **Primary**   | Main brand color       | Headers, buttons       |
| **Secondary** | Supporting brand color | Accents, icons         |
| **Accent**    | Highlight color        | CTAs, links            |
| **Neutral**   | Background/text        | Body text, backgrounds |
| **Success**   | Positive feedback      | Confirmation messages  |
| **Warning**   | Caution indicators     | Alerts                 |
| **Error**     | Error states           | Validation errors      |

### Color Accessibility

RevBridge AI checks your colors for **WCAG accessibility compliance**:

* **AA Standard**: Contrast ratio ≥ 4.5:1 for normal text
* **AAA Standard**: Contrast ratio ≥ 7:1 for normal text

<Tip>
  If your colors don't meet accessibility standards, you'll see a warning. Consider adjusting for better readability.
</Tip>

### Managing Colors

To update your color palette:

1. Click on any color swatch
2. Use the color picker or enter a hex code
3. Click Save

You can also:

* Add additional colors
* Remove unused colors
* Reorder color priority

## Typography

Define your brand's font preferences.

### Font Settings

| Setting          | Description                              |
| ---------------- | ---------------------------------------- |
| **Heading Font** | Font for headlines and titles            |
| **Body Font**    | Font for paragraph text                  |
| **Font Weights** | Available weights (light, regular, bold) |

### Web-Safe Fonts

For email compatibility, RevBridge AI uses web-safe fallbacks:

```css theme={null}
font-family: 'Your Brand Font', Arial, sans-serif;
```

<Warning>
  Custom fonts may not render in all email clients. The AI includes appropriate fallbacks automatically.
</Warning>

## Logo Management

Your logo appears in generated email templates.

### Uploading a Logo

<Steps>
  <Step title="Click Upload Logo">
    In the Logo section, click **Upload**
  </Step>

  <Step title="Select File">
    Choose your logo file (PNG, SVG, or JPG)
  </Step>

  <Step title="Adjust Placement">
    Configure logo size and position preferences
  </Step>

  <Step title="Save">
    Save your logo settings
  </Step>
</Steps>

### Logo Guidelines

| Format  | Best For                           |
| ------- | ---------------------------------- |
| **SVG** | Best quality, scales perfectly     |
| **PNG** | Transparency support, good quality |
| **JPG** | Smaller file size, no transparency |

**Recommended dimensions**: At least 200px width for clarity.

### Logo Placement

Configure where your logo appears in email templates:

* **Top Left** (Default)
* **Top Center**
* **Custom positioning**

## Brand Voice

Define your brand's communication style.

### Voice Attributes

| Attribute       | Options                                      |
| --------------- | -------------------------------------------- |
| **Tone**        | Formal, Casual, Friendly, Professional       |
| **Personality** | Playful, Serious, Inspirational, Educational |
| **Language**    | Simple, Technical, Conversational            |

### Voice Guidelines

Add specific guidelines for the AI:

* Words to use frequently
* Words to avoid
* Preferred phrases
* Style notes

Example:

```
- Always use "shop" not "buy"
- Avoid exclamation points
- Keep sentences short and direct
- Use customer's first name when available
```

## Brand Assets

Store and manage additional brand assets.

### Supported Asset Types

| Type          | Use                               |
| ------------- | --------------------------------- |
| **Images**    | Product photos, lifestyle imagery |
| **Icons**     | UI elements, category icons       |
| **Patterns**  | Background textures               |
| **Documents** | Brand guidelines PDFs             |

### Uploading Assets

1. Navigate to **Assets → Static**
2. Click **Upload**
3. Select files or drag and drop
4. Add tags for organization

## Using Brand Elements in Templates

When you generate templates:

1. AI reads your complete Brand Dossier
2. Applies your color palette to the design
3. Uses your typography preferences
4. Inserts your logo appropriately
5. Writes copy in your brand voice

<Info>
  The more complete your Brand Dossier, the better your AI-generated templates will match your brand.
</Info>

## Updating Brand Elements

When you update your brand:

1. Make changes in Brand Elements
2. Save the updated Brand Dossier
3. Generate new templates to see changes

<Warning>
  Existing templates are not automatically updated. Generate new templates or manually edit existing ones.
</Warning>

## Best Practices

### Complete Your Profile

Fill in all sections:

* ✅ All color categories
* ✅ Typography settings
* ✅ High-quality logo
* ✅ Brand voice guidelines

### Keep It Consistent

Ensure your Brand Dossier matches your actual website and materials.

### Regular Updates

Review and update your Brand Elements when:

* You rebrand or refresh
* Seasonal campaigns need different colors
* You add new product lines

### Test Generated Output

After updating brand elements:

1. Generate a test template
2. Review the output
3. Adjust settings if needed