# How to teach AI your brand guidelines and voice

URL: https://blackbox.plus/guides/teach-ai-your-brand
Level 1: Get set up (https://blackbox.plus/guides/get-set-up)
Updated: 2026-10-26
Time: about 10 minutes
You'll end with: A brand profile you confirmed, built from your own files, that every brief and post is written from
Do it in Blackbox: https://blackbox.plus/app/studio?tab=brands

> Hand Blackbox your brand guidelines, decks and pages, then confirm what is true in the brand profile. Briefs and posts are written from what you confirm.

## Short answer

To teach Blackbox (blackbox.plus) more about your brand than its website says, open the brand in Studio and use its Knowledge and Profile cards. In Knowledge, drop in your brand guidelines, decks, product sheets or old briefs, as PDF, PowerPoint, Word, images, text or CSV up to 50 MB each, or paste a link to a public page; each is read into passages Blackbox can search. In Profile, click Suggest changes: Blackbox reads those files and how your posts did, and suggests lines about your audience, positioning, voice and what works, each with how sure it is and what it rests on. Click Add to the profile on every line that is true, No on the rest, and type anything else you know for certain into What we know for certain. Every brief and post is written from what you confirmed, never from a suggestion nobody added; the scenes your pictures show sit under Pictures on the Look card.

## You'll need

- **A brand in Studio.** Set up from your website first; this guide adds to it. (Guide: https://blackbox.plus/guides/set-up-brand-kit)
- **Your brand files, if you have them.** Brand guidelines, a deck, a product or price sheet, old briefs. PDF, PowerPoint (.pptx), Word (.docx), images, text or CSV.

## How to teach AI your brand guidelines and voice in Blackbox

1. **Open your brand.** In **Studio**, open the **Brands** tab and click **Edit** on your brand.
   You'll see: The brand page, with a **Knowledge** card and a **Profile** card.
   Starts at: https://blackbox.plus/app/studio?tab=brands
   ![Studio’s Brands tab with the Daybreak Coffee Co. card, its Edit link ringed](https://blackbox.plus/guides/teach-ai-your-brand/01-brand.png)
2. **Open Knowledge.** On the **Knowledge** card, click **Open** (or **Add files or a link** when it is empty).
   You'll see: The **Knowledge** panel, with what is in already at the bottom.
   ![The brand page’s Knowledge card listing the brand guidelines, a catering sheet and the beans page, its Open button ringed, beside the Profile card](https://blackbox.plus/guides/teach-ai-your-brand/02-open-knowledge.png)
3. **Add a file.** Drop your brand guidelines or a deck on **Drop files here, or click to choose**.
   You'll see: The file at the top of the list, marked **Reading** while it is read.
   ![The Knowledge panel: Drop files here, or click to choose, ringed, with PDF, PowerPoint, Word, images, text and CSV up to 50 MB each, above a fall menu deck marked Reading](https://blackbox.plus/guides/teach-ai-your-brand/03-file.png)
4. **Add a page.** Paste a page’s address into **…or paste a link** and click **Add link**.
   You'll see: The page in the list, with its address under its title.
   ![A page address pasted into the link box with Add link ringed, and the beans page already in the list with its address under its title](https://blackbox.plus/guides/teach-ai-your-brand/04-link.png)
5. **Check each one was read.** Read the line under each item in the list.
   You'll see: How many passages were read from it, its size and when it was added.
   ![The list of what the brand knows: the brand guidelines PDF with 18 passages and 3.4 MB ringed, a catering sheet, the beans page, and the fall menu still being read](https://blackbox.plus/guides/teach-ai-your-brand/05-read.png)
6. **Open Profile.** Click **Done**, then **Open** on the **Profile** card.
   You'll see: The **Profile** panel, with **What we know for certain** and **Suggest changes** at the bottom.
   ![The Profile card on the brand page, starting Two shops in one neighborhood, with its Open button ringed](https://blackbox.plus/guides/teach-ai-your-brand/06-open-profile.png)
7. **Ask for suggestions.** Click **Suggest changes**.
   You'll see: Suggested lines at the top of the panel, under how many there are.
   ![What we know for certain, with the lines already typed in, and the Suggest changes button ringed beside Save profile](https://blackbox.plus/guides/teach-ai-your-brand/07-suggest.png)
8. **Read a suggestion.** Read the line, the reason under it and what it rests on.
   You'll see: Its section, such as **Audience**, how sure it is, and the files or posts behind it.
   ![3 suggested changes, and the first one ringed: Audience, Ask the customer first, 86% sure, weekday commuters who order ahead, why, and the two files it rests on](https://blackbox.plus/guides/teach-ai-your-brand/08-suggestion.png)
9. **Add the true ones.** Click **Add to the profile** on each line that is right, and **No** on the rest.
   You'll see: The line moved down to **Confirmed by a person**.
   ![Confirmed by a person after Add to the profile, the new Audience line about weekday commuters ringed at the top, above the voice and what-works lines](https://blackbox.plus/guides/teach-ai-your-brand/09-added.png)
10. **Write what you know.** Add anything else that is certain to **What we know for certain** and click **Save profile**.
   You'll see: **Profile saved**, and the time it was confirmed above the box.
   ![What we know for certain with a line added about oat milk, and Save profile ringed](https://blackbox.plus/guides/teach-ai-your-brand/10-certain.png)
11. **Open the pictures.** Click **Done**, then **change** next to **Pictures** on the **Look** card.
   You'll see: The **Pictures** panel, with the picture style and **What the pictures show**.
   ![The Look card’s rows: type, logo, Pictures set to Phone-shot with the change link ringed, and Showing a neighborhood coffee shop that roasts its own beans, 5 scenes](https://blackbox.plus/guides/teach-ai-your-brand/11-pictures.png)
12. **Edit the scenes.** Change or add a scene in the box, one per line, and click **Save scenes**.
   You'll see: **Scenes saved**, and the new count beside **Make again**.
   ![What the pictures show: scenes from the shop, one per line, with a new one added at the bottom and Save scenes ringed](https://blackbox.plus/guides/teach-ai-your-brand/12-scenes.png)

## Good to know

- Briefs and posts are written from the confirmed profile: what you typed and the lines you added. A suggestion nobody added is read by nothing.
- The Inbox’s ad suggestions read what the profile says the brand is — audience, positioning, voice — but never its What works lines.
- An Avoid line that says stops suggesting, such as carousel, stops the Inbox suggesting that kind of post.
- Knowledge is also what the chat and the Inbox search when they need your own words. Search what this brand knows finds what they would find.
- PDFs and pictures are read by AI in the background and can take a few minutes. Decks, Word files and text are read straight away.
- A link is read once, when you add it. If the page changes, remove it with the bin and add it again.
- Ask the customer first marks a line about what the brand is. Anyone on the brand can add it, so check with the owner.
- Make again replaces the scenes with new ones from your facts. It uses a few AI credits and can take up to two minutes.

## Questions people ask

**A file says Needs checking**

The red line says why. Usually there was no text to read, as in a scanned page. Upload a copy with real text, or paste the page as a link, then remove the old one with the bin.

**It says we can’t read that kind of file yet**

Older .ppt and .doc files, Keynote and Pages aren’t read. Save it as PDF, .pptx or .docx and drop it in again.

**Suggest changes says there is nothing to go on yet**

It needs something to read: add a file or a link to Knowledge, or wait until some of your posts have been measured, then click it again.

**Posts still say something I took out**

Removing a file stops it being read, but a line you added from it stays. Click the × on that line under Confirmed by a person. Posts already made keep their words.

**Pictures says there is nothing to show**

Pictures are off for this brand. Tick Put a generated picture behind every slide, pick a style and click Save. Then click change again and Make them.