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 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
- Brand Kit-enabled organization with Owner or Admin permissions, or access to the brand kit as a Collaborator
- To create profiles with Polaris: access to 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 and perform the following steps:
Navigate to the App Switcher in the top-right corner and select Brand Kit.
Select the brand kit in which you want to create the profile.
On the Profiles page, click New Profile.
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.
(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.
(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.
Click to enlargeClick 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.
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.
Click to enlarge
Polaris saves the profile and gives it a name based on your request. The editor unlocks and shows the draft.
Click to enlargeNote 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:
- On the Profiles page, click New Profile.
- In the Create Brand Profile dialog, click Skip, I'll create manually.
- Enter a Profile name (required). The name must be 2 to 100 characters long.
- Click Create. A blank editor opens.
- Write the content for your profile. Use headings for each section, such as tone, words to use, words to avoid, and a sample.
- 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
- On the Profiles page, click the profile name, or click the actions menu (⋮) on its row and select Edit.
- Make your changes in the editor.
- 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. |
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.
Open an entry in the entry editor, and click the Polaris icon to open the Polaris panel.
In the Polaris composer, click + and select Brand Kit.
In the Select a Brand Kit Profile dialog, select a brand kit on the left, and then select a profile.
Click Use profile. The profile appears as context above the message box, next to the page context.
Click to enlargeEnter 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.
Click to enlargeTo 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.