# Brand Context and Website Crawler

The context layer that makes Octo smarter about your brand: a crawler you point at your properties, plus the context you add. That includes brand guidelines, audience notes, catalog, partner rules, policies, technical notes, and legal paper, all of which Octo reads before every proposal.

Brand context is everything Octo knows about your company before it proposes anything. The website crawler reads your properties and extracts the brand kit, page types, categories, content sources, sign-in, and partners. It keeps them current on a schedule.

[Octo](https://begenuin.com/developers/get-started/any-business/octo-operates-your-business-account-octo-proposes-you-approve), Genuin's Supervised Intelligence interface in your Business Account, proposes this capability when it finds a fit on your sites and apps. It completes the steps under Set it up from your brand context. Nothing goes live until you approve it. It's part of [Supervised Intelligence](https://begenuin.com/developers/browse-by-products/supervised-intelligence/supervised-intelligence-what-it-does-and-where-to-start), and [Octo operates your Business Account: Octo proposes, you approve](https://begenuin.com/developers/get-started/any-business/octo-operates-your-business-account-octo-proposes-you-approve) explains how context shapes each proposal.

## When to use it

Start on day one. The more Octo knows, the closer its first proposal is to what you'd have built. Re-crawl after a redesign or a catalog change.

| Context you add | Example | What it shapes |
| --- | --- | --- |
| Audience notes | "Our listeners are first-time home buyers" | Classification and the hub layout |
| Partner rules | "No competitors of X" | The partner edges Octo proposes in [Add brand partners and demand partners](https://begenuin.com/developers/get-started/any-business/add-partners) |
| Technical notes | "We use a cookie named x on web and a JWT in the app" | The auto login exchange, written against your real setup |
| Policies | Legal constraints and past incidents | Moderation and guidelines |
| Legal paper | MSAs, DPAs, and procurement rules | Agreement drafts, with conflicts flagged before your legal team sees them |
| Brand guidelines | Entries on Brand Guidelines, each with a title of up to 50 characters and a description of up to 160 characters | Captions, titles, and partner-facing copy |

## How it works

- The crawler reads only properties you approve. Page types and categories it learns per site are what your grid is drafted from, as [Register your placements on the Hierarchical Grid](https://begenuin.com/developers/get-started/any-business/register-placements) shows.
- Octo writes a brand summary from the crawl and the context you add.
- Every approval and inline edit teaches Octo too.
- Context sources are set per brand. In a Business Account with several brands, they're shared across brands where you allow it.

## Set it up

Octo proposes the crawl with these steps already done. You review the result and confirm it.

1. Under **Brand** > **Context**, choose **Crawl my site** and approve the properties to crawl. Octo proposes a schedule: daily for news, weekly for catalogs. [Connect your website, app, and podcast feed](https://begenuin.com/developers/get-started/any-business/connect-properties) covers how properties are verified.
2. Add guidelines, audience notes, partner rules, policies, and technical notes as files, links, or plain text. Octo confirms what it learned in one paragraph.
3. Review Octo's brand summary and correct it. Corrections are weighted above the crawl.

### During brand setup in Build

When you set up a new brand, **Build** offers two paths. With the AI-assisted path, click the **Octo** icon in the bottom-right corner and enter your website URL in the chat. Octo builds your brand setup, which takes some time. Then Business Account takes you to **Launch Community Media Network**.

With the manual path, you enter your website URL on **Brand Assets** yourself. Business Account uses it to fill in parts of the setup for you to review:

- **Brand Assets**: your brand logo, fetched from the URL. Three logos are required.
- **Brand Color**: **Primary**, **Secondary**, and **Tertiary** colors, generated from the URL.
- **Brand Type**: one answer to each of its three questions (industry type, brand type, and monthly traffic range), pre-selected from your website. You can change any of them.

Other setup steps start from suggestions you edit. **Brand Categories** shows AI-suggested categories, and deselected ones aren't saved when you click **Continue**. The **Add guidelines** drawer lists suggested guidelines next to your saved ones. Each guideline has a title of up to 50 characters and a description of up to 160 characters. **Brand Persona** can start with pre-filled statements you edit or clear, and it takes an optional supporting .csv document.

If you change the website URL on **Brand Assets** later, a **Change Brand URL** popup asks you to confirm. Clicking **Keep URL**, or closing the popup, leaves the URL as it was.

## Settings

| Setting | What it controls |
| --- | --- |
| Crawl scope | Which verified properties the crawler reads |
| Crawl schedule | How often each property is read again |
| Context sources | What each brand's context includes, and whether brands in your Business Account share it |
| Infer or ask | What Octo can infer on its own and what it must ask you |

Change all four under **Brand** > **Context**, which also holds **Technical notes**, **Policies**, **Partners**, and **Legal**.

After setup, the brand context from **Build** also lives under **Settings**. **Brand Elements** holds the logo, slogan, colors, and CTAs, next to **Brand Guidelines** and **Brand Persona**. Changes saved on these pages show in **Build** too.

## What it reports

Octo reports what it knows and how that changed its work. [How Octo gets smarter](https://begenuin.com/developers/get-started/any-business/octo-operates-your-business-account-octo-proposes-you-approve) explains the loop.

- **Context coverage score**: a score for how complete Octo's context is.
- **Proposals changed by context**: the proposals your context shaped.
- **Re-crawl history**: when each property was crawled again.
- **What Octo learned this week**: a weekly summary of new context.

## Connect your systems

Brand context and the crawler run in your Business Account and need no code. For your integration, [Environments, credentials, and test data](https://begenuin.com/developers/developer-resources/guides/environments-credentials-and-test-data) covers the environments and credentials your developers use.

The context and crawl calls in the [Business Account API](https://begenuin.com/developers/get-started/any-business/business-account-api-provisioning-oauth-and-the-resource-map) are proposed, not live. [Live API today and the Business Account API roadmap](https://begenuin.com/developers/developer-resources/guides/live-api-today-and-the-business-account-api-roadmap) maps what you can call now to what's planned.