---
title: "Brand Profiles"
description: "Create Brand Profiles in Contentstack Brand Kit to give AI your brand's voice, image, and translation guidelines, and use them in Polaris."
url: "https://www.contentstack.com/docs/brand-kit/brand-profiles"
product: "Contentstack"
doc_type: "guide"
audience:
  - developers
  - admins
version: "current"
last_updated: "2026-11-18"
---

# Brand Profiles

Brand Profiles are Markdown documents in a brand kit that tell AI how your brand writes, looks, and translates.

Each profile is a single document that you structure the way your brand needs, with your own headings, sections, and content. Contentstack AI features, such as Polaris, use the profile as context when they create or rewrite content.

A brand profile can be anything you want. Here are a few examples:

*   **Voice Profile:** How your brand sounds in writing, such as personality, tone, and word choices.
*   **Translation Guidelines:** Rules for translating content across languages and locales.
*   **Image Profile:** The visual style to use when creating or choosing images.

**Note:** Brand Profiles are available in brand kits that show a **v2** badge. Older brand kits are unaffected by this change, and their [Voice Profiles](/docs/brand-kit/about-voice-profile) can continue to be used. Brand Profiles aren't available in the AWS North America (NA) region yet. They will be available there later.

## Prerequisites

*   [Contentstack account](https://www.contentstack.com/login/)
*   Brand Kit-enabled organization with [Owner or Admin](/docs/administration/about-administration-roles) permissions, or access to the brand kit as a [Collaborator](/docs/brand-kit/invite-collaborators)
*   To create profiles with Polaris: access to [Polaris](/docs/agent-os/get-started-with-polaris) in your organization

## Create a Brand Profile with Polaris

Polaris can draft a profile from a short description, a template, and your existing brand documents.

To create a Brand Profile with Polaris, log in to your [Contentstack account](https://www.contentstack.com/login) and perform the following steps:

1.  Navigate to the App Switcher in the top-right corner and select **Brand Kit**.
    
2.  Select the brand kit in which you want to create the profile.
    
3.  On the **Profiles** page, click **New Profile**.
    
4.  In the **Create Brand Profile** dialog, describe the profile you want Polaris to draft. For example: _Create a Voice Profile for our marketing team using the attached brand guidelines._
    
5.  (Optional) Under **Start with a template**, select a template, such as **Voice Profile**. The template adds the start of a prompt and sets the structure of the draft. Complete the prompt after the template text.
    
6.  (Optional) To give Polaris additional context about your brand, click **+** and select one or more files. You can attach PDF, plain text (.txt), and Markdown (.md, .markdown) files of up to 1 MB each.
    
    ![The Create Brand Profile dialog with an attached file, a prompt, and the Voice Profile template](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/am7f21bc34096cb4ca/8945cbe0273416b157797a4c/create-profile-attachment.png)
7.  Click **Create Brand Profile**. The button is available once you enter a prompt or select a template.
    
    The profile opens in the editor, and the Polaris panel shows its progress. The editor stays locked with the message **Polaris is drafting this profile…** until the draft is ready.
    
8.  Review the draft in the Polaris panel. If the approval mode in the Polaris composer is set to **Manual**, Polaris shows the draft with **Update this profile?**. Click **Update** to apply it, or **Cancel** to discard it.
    
    ![Polaris shows the drafted Voice Profile with Update this profile?](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/am44f62957ba7b4360/1ad09a10cb1ae25e18b42c24/polaris-update-profile-card.png)

Polaris saves the profile and gives it a name based on your request. The editor unlocks and shows the draft.

![The drafted profile in the editor, with Polaris's summary in the panel](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/am767ae65e86d837d6/494901138914139776996c81/polaris-drafted-profile.png)

**Note:** Treat the draft as a starting point. Check every section against your real brand guidelines, and replace sample content with text your brand has actually published.

## Create a Brand Profile Manually

To write a profile yourself, perform the following steps:

1.  On the **Profiles** page, click **New Profile**.
2.  In the **Create Brand Profile** dialog, click **Skip, I'll create manually**.
3.  Enter a **Profile name** (required). The name must be 2 to 100 characters long.
4.  Click **Create**. A blank editor opens.
5.  Write the content for your profile. Use headings for each section, such as tone, words to use, words to avoid, and a sample.
6.  Click **Save**. The profile appears in the **Profiles** list.

**Note:** A profile you create manually is saved only when you click **Save**. If you leave the editor before you save, the profile isn't created.

## Edit a Brand Profile

1.  On the **Profiles** page, click the profile name, or click the actions menu (**⋮**) on its row and select **Edit**.
2.  Make your changes in the editor.
3.  Click **Save**.

The editor has the following controls:

Control

What it does

**Outline**

Shows or hides a list of the profile's headings.

**Heading**

Formats the line as a heading, from heading 1 to heading 6.

**B**, **I**, **U**

Bold, italic, and underline.

Inline code (**</>** in the formatting toolbar)

Formats text as inline code.

Bulleted list, numbered list, quote, link

Adds lists, a quote, or a link.

Formatted view (eye icon at the right of the toolbar)

Shows the profile formatted.

Markdown view (**</>** at the right of the toolbar)

Shows the Markdown source.

Profile name

Click the name at the top to rename the profile.

More options (**⋯**)

Shows **Delete Profile**.

![A Brand Profile in the editor, with the Outline panel and the formatted view](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/am4926df3349750229/edbddadb400d97c5a9ddf9b3/profile-editor-rendered.png)

**Note:** The editor doesn't warn you about unsaved changes. Click **Save** before you leave the editor.

## Manage Brand Profiles

The **Profiles** page lists every profile in the brand kit, with the **Title** and the **Modified At** date. New profiles show a **New** label.

*   **Search:** Enter a name in **Search Profiles**.
*   **Edit:** Click the profile name, or select **Edit** in the actions menu (**⋮**).
*   **Delete:** Select **Delete** in the actions menu (**⋮**), and then click **Delete** to confirm. You can't restore a deleted profile.
*   **Set the default profile:** In the brand kit, click **Settings**. Under **Default Voice**, select a profile, and then click **Save**.

If you create a profile with a name that already exists in the brand kit, Contentstack adds a number to the new name, for example, **Trailmark Voice (1)**.

## Use a Brand Profile in Polaris

You can attach a Brand Profile to a Polaris conversation, so that Polaris follows it when it writes or rewrites content.

1.  Open an entry in the entry editor, and click the **Polaris** icon to open the Polaris panel.
    
2.  In the Polaris composer, click **+** and select **Brand Kit**.
    
3.  In the **Select a Brand Kit Profile** dialog, select a brand kit on the left, and then select a profile.
    
4.  Click **Use profile**. The profile appears as context above the message box, next to the page context.
    
    ![The Select a Brand Kit Profile dialog](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/am1119b110fa98d33d/b588ab149534c9d7bb93e39b/select-brand-kit-profile.png)
5.  Enter your request. For example: _Rewrite the Body of this entry in the attached brand voice. Keep the link._
    

Polaris applies the profile to its response and, for changes to an entry, shows the proposed content for you to review before it updates the entry.

![Polaris proposes an entry update written in the attached profile's voice](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/am9a95447bd4becf0c/17743b20703f86c4c2ef2b7a/polaris-entry-rewrite-with-profile.png)

To stop using the profile in the conversation, click **x** on the profile's context label.

## Tips for Effective Brand Profiles

*   **Write rules, not descriptions.** _Use short sentences and no exclamation marks_ gives AI more to follow than _our voice is energetic_.
*   **Add real sample content.** One paragraph your brand has published shows the voice better than a description.
*   **List words to use and words to avoid.** Both help AI choose the right words.
*   **Use clear headings.** Headings make the profile easier for AI to follow and easier for your team to navigate in the **Outline**.
*   **Keep each profile focused.** If a profile gets long, split it into several profiles, for example, one voice profile per audience.

## Limitations

*   Attachments for Polaris drafting can be PDF, .txt, .md, or .markdown files of up to 1 MB each.
*   Drafting a profile with Polaris uses your organization's AI credits. If your organization has no AI credits left, Polaris shows **Unable to reserve AI credits for this run** and doesn't draft the profile. You can still write the profile yourself in the editor.