---
title: Manage a Brand Pack
slug: agent-platform/docs/manage-a-brand-pack
createdAt: 2026-08-26T23:21:18.000Z
---

Use the Brand Pack details page in Mark (Optimizely Agent Platform) to add the resources and guidance that make up a Brand Pack. To open the Brand Pack details page, go to **Context > Brand Packs** and click a Brand Pack.

![Screenshot of the Brand Packs page where a Brand Pack card is selected to open its details page](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/FZY6gKhUfXlW1qhhgOmaB_select-a-brand-pack.png)

The Brand Pack details page includes the following pages:

- **Overview** – A summary of the Brand Pack, including its identity and a card for each area.
- **Resources** – The Brand Pack's assets, colors, and typefaces.
- **Guidance** – The rules for using the Brand Pack.
- **History** – The published versions of the Brand Pack.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/XgUu7kQizrBPzyEF0D_Vd_brand-packs-overview.png" size="100" isUploading="false" position="center" width="2234" height="1096" darkWidth="2234" darkHeight="1096" alt="Screenshot of a Brand Pack details page where the Overview, Resources, and Guidance pages are listed" showCaption="false" indent="1"}

The header displays the Brand Pack name and status. It also includes options to export the Brand Pack as JSON and to publish it. See [Publish and use a Brand Pack](https://docs.optimizely.com/agent-platform/docs/publish-and-use-a-brand-pack).

## Add or edit the Brand Pack identity

The Brand Pack identity is a short description of what the Brand Pack is. It displays on the **Overview** page. When you publish, Mark includes the identity in the generated skill. To add or edit the identity, complete the following steps:

1. Open the Brand Pack.
2. Click **Add a Brand Pack identity**. If an identity exists, click **Edit Brand Pack identity** instead.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/jVUaqXYXxl_Vj006ok3V4_edit-brand-identity.png" size="100" isUploading="false" position="center" width="1858" height="1126" darkWidth="1858" darkHeight="1126" alt="Screenshot of the Brand Pack details page where Edit Brand Pack identity is highlighted" showCaption="false" indent="1"}

3. Enter the identity. The limit is 2,000 characters, and the identity supports Markdown formatting.
4. Click **Save**.

## Manage resources

**Resources** are the building blocks of a Brand Pack. They include assets, colors, and typefaces.

### Add assets

Assets are the logos, photos, backgrounds, and templates in the Brand Pack. To upload assets from your computer, complete the following steps:

1. Click **Add asset**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Vae5U9Mznv5_4d6fDaTu9_brand-packs-assets.png" size="100" isUploading="false" position="center" width="2214" height="878" darkWidth="2214" darkHeight="878" alt="Screenshot of the Assets page where Add asset is highlighted" showCaption="false" indent="1"}

2. Click **Upload from this computer**.
3. Find the files you want to upload.
4. Click **Open**.

To add assets from the Optimizely Content Marketing Platform (CMP) library, complete the following steps. See [Manage assets](https://docs.optimizely.com/content-marketing-platform/docs/manage-assets) in the CMP documentation for details.

1. Click **Add asset**.
2. Click **Pick from CMP Library**.
3. Select the images you want to add.
4. Click **Choose**.

### Add colors

The **Colors** page displays the Brand Pack's palette.

![Screenshot of the Colors page with the palettes and colors](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/J6y-xfm6ahmSZGO-HLSID_brand-colors.png)

The **Palette** groups colors by role and displays every color in the Brand Pack. Each swatch displays the color's name and its hex value, or its print value when the color has no hex value. The palette has the following groups:

- **Primary** – Displays in its own row with wide swatches.
- **Secondary**, **Accent**, **Neutral**, **Extended**, **Do not use**, and **Unassigned** – Share one row after **Primary**. **Unassigned** holds colors that have no role. A role with no colors does not display.

The **All colors** table lists every managed color with its role and values.

![Screenshot of the All colors table on the Colors page](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/GTLmNuqSz2Yk50HFTk3zQ_all-colors-table.png)

The **All colors** table has the following columns:

- **Color** – The color's swatch and name.
- **Role** – The color's role.
- **Hex** – The hexadecimal value. Hover over a row to display a copy icon beside the value, and click the icon to copy the value. A **Copied** message confirms the copy.
- **CMYK** – The print value, written with a slash between each part, such as 50 / 0 / 100 / 0.
- **PMS** – The Pantone Matching System value.

Each row has **Edit** and **Delete** icons. Click **Edit** to change the color. Click **Delete** to remove it. **Delete** asks you to confirm, and the confirmation notes any rules that reference the color. The icons display only when you can edit the Brand Pack.

To add a color, complete the following steps:

1. Click **Add color**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/xPzL2CyIv3FPwEsAHzS11_add-color.png" alt="Screenshot of the Add color dialog where the Name, Role, HEX, CMYK, PMS, and Accessible HEX fields display" size="90" isUploading="false" position="center" width="1102" height="734" darkWidth="1102" darkHeight="734" showCaption="false" indent="1"}

2. Complete the following fields:
   - **Name** – A friendly name for the color.
   - **Role** – A label for the color. Select from **Primary**, **Secondary**, **Accent**, **Neutral**, **Extended**, or **Do not use**. Roles help you identify each color at a glance.
   - **HEX** – The hexadecimal (**HEX**) color value. Mark computes the red, green, and blue (**RGB**) value.
   - **CMYK** – The print color value in cyan, magenta, yellow, and key (**CMYK**) format.
   - **PMS** – The Pantone Matching System (**PMS**) value.
   - **Accessible HEX** – The color to pair with this one for accessible contrast.
3. Enter at least one color value: **HEX**, **CMYK**, or **PMS**.
4. Click **Add color** in the dialog.

### Add typefaces

The **Typefaces** page lists the Brand Pack's typefaces. The **Typography** card on **Overview** also opens this page.

![Screenshot of the Typefaces page where each typeface displays its name and specimen preview](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/hIhrJDOkQ34zjX5UTqvym_brand-packs-typography.png)

Each typeface displays its name, licensing, fallback font, and specimen preview.

Assign each typeface an optional role of **Primary**, **Secondary**, or **Display**. Mark includes the role in the published skill so agents know how you intend to use each typeface.

To add a typeface from Google Fonts, complete the following steps:

1. Click **Add Typeface**.
2. Select **Google Fonts**.

::Image[]{alt="Screenshot of the Add typeface dialog where Google Fonts is selected as the source" src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/CSnIVfYqjX_liVlnlVLul_brand-packs-add-typeface.png" size="100" isUploading="false" position="center" width="1936" height="830" darkWidth="1936" darkHeight="830" showCaption="false" indent="1"}

3. Search for a font family.
4. Select the font family.
5. Select the weights you want in **Weights & styles**.
6. Click **Add fonts**.
7. (Optional) Assign a role: **Primary**, **Secondary**, or **Display**.
8. Click **Add typeface**.

To add a typeface from a font file, complete the following steps:

1. Click **Add Typeface**.
2. Select **Upload file**.

::Image[]{alt="Screenshot of the Add typeface dialog where Upload file is selected as the source" src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/G1BTnfxii_gyfGB5PPyIb_brand-packs-add-typeface-file.png" size="100" isUploading="false" position="center" width="1924" height="860" darkWidth="1924" darkHeight="860" showCaption="false" indent="1"}

3. Click **Choose files** and select one or more font files with the `.ttf`, `.woff`, or `.woff2` extension.
4. (Optional) Assign a role: **Primary**, **Secondary**, or **Display**.
5. Click **Add typeface**.

## Manage guidance

The **Guidance** pages hold the rules for using the Brand Pack. Unlike the fixed **Resources** pages, guidance pages vary by Brand Pack. Mark creates them when it extracts a Brand Pack from your sources, or you add and title your own.

![Screenshot of the Guidance page where guidance pages are listed](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/st7RMDZkHnwzTQShdmKvd_brand-packs-guidance-section.png)

**Guidance** uses a consistent three-level structure so any rule fits:

- A page covers one area of the Brand Pack, such as brand foundations or voice and messaging.
- A section groups related rules within a page.
- A rule is one instruction that Mark follows.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/pEbmWzjqmerRZjohdcX33_guidance-breakdown.png" alt="Diagram of the three guidance levels where a page contains sections and a section contains rules" size="100" isUploading="false" position="center" width="1582" height="1572" darkWidth="1582" darkHeight="1572" showCaption="false" indent="1"}

### Edit a guidance page

To edit a guidance page, complete the following steps:

1. Click **More > Edit guidance** on the guidance list or the guidance details page.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/fgXlP-c71ZsQKjR9QPqPK_brand-packs-edit-guidance.png" size="100" alt="Screenshot of the More menu where Edit guidance is selected" isUploading="false" width="2410" height="1178" darkWidth="2410" darkHeight="1178" position="center" showCaption="false" indent="1"}

2. Update the **Title**, **Description**, or **Enabled** option.
3. (Optional) Expand **Authoring notes** to add a note, tags, or properties.
4. Click **Save**.

The guidance page has the following options:

- **Title** – The name of the area, such as *Illustration and AI*.
- **Description** – What this part of the Brand Pack covers.
- **Enabled** – Whether the page is active. Disable a page to leave it out of the generated skill while you finish working on it.
- **Authoring notes** – Context for editors. Mark does not receive authoring notes or include them in the generated skill. Expand **Authoring notes** to add the following:
  - **Note** – A free-text comment for other editors.
  - **Tags** – Keywords that label the page for editors. Reuse an existing tag or add a new one. Tags display with the note when you open the page details.
  - **Properties** – Name and value pairs for extra reference information, such as data Mark captured when it built the Brand Pack. Give each property a unique name.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/JS2xc5rzhw-Os3GlikURk_brand-packs-edit-guidance.png" alt="Screenshot of the guidance page editor where the Title, Description, Enabled, Note, Tags, and Properties options are shown" size="80" isUploading="false" position="center" width="1151" height="1188" darkWidth="1151" darkHeight="1188" showCaption="false" indent="1"}

### Add a section

Within a page, add a section to group related rules. A section has the same options as a guidance page: **Title**, **Description**, **Enabled**, and **Authoring notes**. To add a section, complete the following steps:

1. Select a guidance page.
2. Hover over the end of the guidance until **Add section** displays.
3. Click **Add section**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/0_1PwomzClxm4is9gyzJF_brand-packs-add-section-guidance.png" size="100" alt="Screenshot of the Add section dialog where the Title, Description, and Enabled options are shown" isUploading="false" width="1336" height="679" darkWidth="1336" darkHeight="679" position="center" showCaption="false" indent="1"}

4. Complete the options and click **Add section**.

Click **Add sub-section** inside a top-level section to nest sections when a Brand Pack needs finer structure.

Disable a section to leave it out of the generated skill while you finish working on it.

### Add a rule

To add a rule, complete the following steps:

1. Select a guidance page.
2. Hover over a section in the guidance.
3. Click **Add rule**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/7Veh8TMGuNJjgnYd0EhBp_brand-packs-add-rule.png" size="100" alt="Screenshot of the Add rule dialog where the Label, Description, and Referenced resources options are shown" isUploading="false" width="1332" height="581" darkWidth="1332" darkHeight="581" position="center" showCaption="false" indent="1"}

4. Complete the options and click **Add rule**.

A rule has the following options:

- **Label** – A short name for the rule, such as *Illustration style*.
- **Description** – The instruction you want an agent to follow.
- **Referenced resources** – The exact colors, typefaces, and assets the rule applies to. Referencing a resource removes ambiguity. The published skill includes each resource's exact value with the rule, such as a color's hex value.
- **Enabled** – Whether the rule is active.
- **Authoring notes** – Context for editors, as for a guidance page.

## Export a Brand Pack

To export a Brand Pack, hover over its card on the **Brand Packs** tab and click **More > Export**.

::Image[]{alt="Screenshot of a Brand Pack card where More > Export is selected" src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/7XNUCjv7EZQsPSyouEp_z_brand-packs-export-overview.png" size="80" isUploading="false" position="center" width="1826" height="1006" darkWidth="1826" darkHeight="1006" showCaption="false"}

Alternatively, click **More > Export** on the details page or on a version.

::Image[]{alt="Screenshot of the Brand Pack details page where More > Export is selected" src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/-zeJcKzsWVUp95Nv_4_-g_brand-packs-export-from-details.png" size="80" isUploading="false" position="center" width="1934" height="624" darkWidth="1934" darkHeight="624" showCaption="false"}

Choose one of the following options:

- **Download JSON** – Download the Brand Pack document. It references uploaded files instead of including them, so it works best within the same Mark instance.
- **Download (zip)** – Download the document with its files, so the Brand Pack carries to another Mark instance.
- **Copy to clipboard** – Copy the JSON.

Use the export to share the Brand Pack with another team or to import it into another Mark instance. See [Create a Brand Pack](https://docs.optimizely.com/agent-platform/docs/create-a-brand-pack) for import steps.

## Next steps

Continue with the following articles:

- [Publish and use a Brand Pack](https://docs.optimizely.com/agent-platform/docs/publish-and-use-a-brand-pack) – Publish the Brand Pack and apply it to your content.
- [Create or update from chat](https://docs.optimizely.com/agent-platform/docs/create-a-brand-pack#create-or-update-from-chat) – Add sources to a Brand Pack, or describe changes, by asking Mark in chat.

:::hint{type="info"}
**Note**

If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See [Turn generative AI off across Optimizely applications](https://docs.optimizely.com/opti-id/docs/generative-ai-settings).
:::
