Manage a Brand Pack
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.

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.

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.
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:
- Open the Brand Pack.
- Click Add a Brand Pack identity. If an identity exists, click Edit Brand Pack identity instead.

- Enter the identity. The limit is 2,000 characters, and the identity supports Markdown formatting.
- 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:
- Click Add asset.

- Click Upload from this computer.
- Find the files you want to upload.
- Click Open.
To add assets from the Optimizely Content Marketing Platform (CMP) library, complete the following steps. See Manage assets in the CMP documentation for details.
- Click Add asset.
- Click Pick from CMP Library.
- Select the images you want to add.
- Click Choose.
Add colors
The Colors page displays the Brand Pack's palette.

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.

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:
- Click Add color.

- 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.
- Enter at least one color value: HEX, CMYK, or PMS.
- 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.

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:
- Click Add Typeface.
- Select Google Fonts.

- Search for a font family.
- Select the font family.
- Select the weights you want in Weights & styles.
- Click Add fonts.
- (Optional) Assign a role: Primary, Secondary, or Display.
- Click Add typeface.
To add a typeface from a font file, complete the following steps:
- Click Add Typeface.
- Select Upload file.

- Click Choose files and select one or more font files with the .ttf, .woff, or .woff2 extension.
- (Optional) Assign a role: Primary, Secondary, or Display.
- 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.

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.

Edit a guidance page
To edit a guidance page, complete the following steps:
- Click More > Edit guidance on the guidance list or the guidance details page.

- Update the Title, Description, or Enabled option.
- (Optional) Expand Authoring notes to add a note, tags, or properties.
- 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.

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:
- Select a guidance page.
- Hover over the end of the guidance until Add section displays.
- Click Add section.

- 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:
- Select a guidance page.
- Hover over a section in the guidance.
- Click Add rule.

- 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.

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

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 for import steps.
Next steps
Continue with the following articles:
- Publish and use a Brand Pack – Publish the Brand Pack and apply it to your content.
- Create or update from chat – Add sources to a Brand Pack, or describe changes, by asking Mark in chat.
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.