> For the complete documentation index, see [llms.txt](https://oodlz-ai-studio.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://oodlz-ai-studio.gitbook.io/docs/getting-started/your-brand-profile.md).

# Your Brand Profile

Field-by-field guide to the Brand Profile — what each field does, which producer reads it, when to update it.

> **One record, every producer's source of truth — what each field does, who reads it, when to change it.**

The Brand Profile is the most important record in the workspace. Every producer reads from it at runtime. Changing a field here propagates to every workflow run that fires after the change. The full field map is below — what the field is for, which producer uses it, and when changing it makes sense.

Connected channels and their status are held in the Brand Profile and shown in System Health.

## Identity

| Field             | What it does                                                             | Who reads it        |
| ----------------- | ------------------------------------------------------------------------ | ------------------- |
| Brand Name        | Brand display name; appears in Inbound replies and Repurpose social copy | All producers       |
| Brand Description | 1–3 sentences of brand positioning; injected into LLM prompts            | All producers       |
| Brand URL         | Primary website URL                                                      | All producers       |
| WordPress URL     | WordPress install URL for article publishing                             | Articles, Repurpose |

## Voice And Audience

| Field                | What it does                                                                                                 | Who reads it                          |
| -------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------- |
| Brand Tone           | Tone description; injected into every LLM prompt                                                             | All producers                         |
| Brand Colors         | JSON object with primary and accent colours; used in image generation prompts and email templates            | Articles, Repurpose, Human Escalation |
| Audience Description | Demographic and psychographic audience summary                                                               | Topics, Articles                      |
| Audience Lifestyle   | Lifestyle descriptor for emotional topic generation                                                          | Topics                                |
| Product Type         | Single-word product category (e.g. cashback, insurance, ecommerce); contextualises the Inbound Agent's voice | Inbound Agent                         |

## Constraints

| Field               | What it does                                     | Who reads it                                                            |
| ------------------- | ------------------------------------------------ | ----------------------------------------------------------------------- |
| Prohibited Language | Comma-separated banned words and phrases         | All producers — outputs containing these are rejected before publishing |
| Product Exclusions  | Product categories excluded from content         | Topics, Articles                                                        |
| Brand Exclusions    | Competitor domains excluded from topic discovery | Topics                                                                  |

## Content Scope

| Field              | What it does                                                       | Who reads it |
| ------------------ | ------------------------------------------------------------------ | ------------ |
| Categories         | Content category list relevant to the brand                        | Topics       |
| Markets            | Multi-select of markets the brand operates in (USA, UK, Australia) | Topics       |
| Markets DataForSEO | JSON mapping of markets to platform-specific location codes        | Topics       |

## Topics Configuration

| Field           | What it does                                                                      | Who reads it |
| --------------- | --------------------------------------------------------------------------------- | ------------ |
| Competitor Seed | Comma-separated fallback competitor domains, used if live discovery underperforms | Topics       |
| Competitors     | JSON array of competitor objects (name, url)                                      | Articles     |
| Topics Target   | Target topic count per discovery run; default 200                                 | Topics       |

## Articles Configuration

| Field                  | What it does                                              | Who reads it |
| ---------------------- | --------------------------------------------------------- | ------------ |
| Internal Links Enabled | Master switch for internal link injection                 | Articles     |
| Short Link Domain      | Branded short link domain (e.g. `links.brand.io`)         | Repurpose    |
| Short Link Folder ID   | The brand's tracking folder ID at the short link provider | Repurpose    |

## Inbound And Escalation

| Field         | What it does                                                      | Who reads it                     |
| ------------- | ----------------------------------------------------------------- | -------------------------------- |
| Support Email | Email address for human escalation handoff and email templates    | Inbound Agent (Human Escalation) |
| Logo URL      | Brand logo for email templates                                    | Inbound Agent (Human Escalation) |
| Soft Upsell   | Single sentence upsell line for Inbound replies and email footers | Inbound Agent, Repurpose         |

## Master Switches

| Field             | What it does                                                                                                          | Who reads it  |
| ----------------- | --------------------------------------------------------------------------------------------------------------------- | ------------- |
| Active            | Master on/off switch — uncheck to pause every producer for the brand                                                  | All producers |
| Onboarding Status | Provisioning state — In Progress during setup, Active once handover completes, Suspended if the brand is later paused | System Health |

## When To Update Each Field

* **Brand Tone, Prohibited Language, Audience Description** — anytime the brand's voice or focus shifts.
* **Categories, Markets** — when expanding into new categories or geographies.
* **Competitor Seed, Brand Exclusions** — when competitor landscape changes.
* **Soft Upsell** — when promotion or campaign focus shifts.
* **Active** — to pause everything, or to reactivate after a pause.

Most identity fields (Brand Name, URL, WordPress URL) and configuration fields (Markets DataForSEO, Short Link Folder ID) are set at onboarding and rarely change.