email-design.md covers how emails are built; image-style.md covers how generated imagery looks.
They are documents, not settings. Brew reads them at generation time, so whatever they say is what you get.
Brand Identity describes what each file holds. Because they’re documents, you edit them the way you’d edit any text.
Open Brand, go to the Email-design.md or Image-style.md tab, and change the line that’s wrong. Switch a CTA from pill to square, tighten a color, rewrite a signature move.
Every email generated after that inherits the change. There’s nothing to save in a separate field; the documents are the source of truth Brew reads at generation time.
1. Let Extraction Write Them, Then Edit
When you add your brand, Brew writes both files from your site, usually in 1 to 3 minutes. If you upload a brand guide, PDF, or markdown during setup, your files win over anything inferred from the site. The domain only fills the gaps your uploads leave. Extraction is a starting point, not the final word. If your site doesn’t reflect your brand accurately, edit the documents directly and your edits stand.2. Start from an Email You Like
If an email already nails the look you want, you can make it the baseline without writing a spec yourself. That includes one Brew generated, a template you remixed, an import, or an email you forwarded in.1
Add the email to chat
Open the email on the canvas and click Add to chat in the toolbar. This brings that specific design into the conversation.
2
Ask Brew to make it the baseline
“Make this the default layout for our emails, and update the brand design to reflect it.”Brew studies the email’s structure, spacing, and signature details, then rewrites
email-design.md to match. Your colors, fonts, and voice stay yours; the layout patterns come from the email.3
Review what changed
Open Brand, go to the Email-design.md tab, and read the updated document. It’s the source of truth. If Brew captured a pattern you don’t want, delete that line and it’s gone from every future generation.
The baseline is a design guide, not a template. Brew learns the patterns and applies them to new content; it doesn’t copy the email.
3. Scope a Baseline to One Email Type
Your newsletter and your product announcements probably shouldn’t share a layout. You can point a specific email type at its own reference instead of changing the global baseline. With the email added to chat:“Whenever I ask for a newsletter, base its design on this email.”Brew records the scoped preference in your brand spec. Newsletter prompts then start from that layout, while everything else keeps following the global baseline. Repeat with a different email for product updates, digests, or any other type you send regularly.
Keep It Current
The files are the single source of truth, so maintenance is editing text:- A pattern stopped working? Delete or rewrite its line in
email-design.md. - Generated images drifting off-style? The fix lives in
image-style.md, including its “do not” list. - Rebranded? Update the two files in place. Hand the new look to chat (add a redesigned email and ask for the update), or edit
email-design.mdandimage-style.mddirectly. An assistant or your code can rewrite either file too; see From an Agent or Code. Deleting the brand and adding it again re-runs extraction too, but it permanently removes every email, contact, and automation in that brand, so treat it as a last resort. See Multiple Brands for what a delete removes.
From an Agent or Code
With Brew connected to your AI assistant over MCP, ask in plain English:“Read my email-design.md, change the buttons from pills to square corners, and keep everything else as is.”The assistant saves the whole file each time, so ask it to keep the rest unchanged. From code,
GET /v1/brand?include=emailDesign,imageStyle reads both files, and brew-cli brand get --json does the same from the terminal. PATCH /v1/brand with emailDesign or imageStyle replaces that file in full.
Related
Brand identity
The map of the Brand page: details, links, and the two design files.
Add your brand
How extraction works, and how to upload an existing brand guide during setup.
Need Help?
Our team is ready to support you at every step of your journey with Brew. Choose the option that works best for you:- Self-Service Tools
- Talk to Our Team
Search Documentation
Type in the “Ask any question” search bar at the top left to instantly find relevant documentation pages.
Ask ChatGPT or Claude
Click here to open the Copy page menu at the top of this page, then send the page to ChatGPT, Claude, or your editor.