Visual Guidelines
Define visual rules and use-case templates in your Brand Kit
Visual Guidelines structure your brand's colors, typography, logos, and visual rules so AI-generated assets stay on-brand.
Using the Brand Kit MCP, you can configure your visual identity (populate it via Claude, for example) and retrieve it just as easily, so that every output is grounded not only in what to say but in how to present it.
The Visual Guidelines tab is organized into Logos, Colors, Typography, and visual use-case templates. Templates keep the instructions and examples for a particular kind of asset together, instead of storing every reference image in one flat collection.
Use Cases
Visual Guidelines can be read and written via MCP, so any connected AI tool can produce on-brand visual output. Here are some examples.
Generate on-brand reports and one-pagers. An AI tool connected via MCP retrieves your exact colors, fonts, type scale, and logo rules, then applies them when generating a report, one-pager, or data summary. AEO performance reports, for example, can be fully branded out of the box.
Produce data visualizations with your brand palette. When your chart color palette, color usage rules, and Data Visualization template are stored in Visual Guidelines, an AI agent can pull them to render charts, graphs, and dashboards that match your brand. Flat fills, specific accent colors, correct axis label fonts.
Build slide decks that look like your brand. Claude or another MCP-connected tool can retrieve your full type scale, logo variants, and color palettes to generate presentation slides that follow your visual identity.
Apply the right creative direction to each asset. A Hero Image can call for expressive editorial art, while a Quote Card can specify a restrained layout and exact logo placement. Each use case carries its own instructions and examples, so guidance for one asset type does not get applied indiscriminately to another.
How to Configure Visual Guidelines
Instead of manually entering every color, font, and rule, you can use Claude via MCP to read your existing brand guidelines, whether that's a PDF, a slide deck, or any other document, and write the structured fields directly into your Brand Kit. This is the fastest way to populate Visual Guidelines.
You can also add fields manually through the Visual Guidelines tab:
Navigate to the Visual Guidelines tab in your Brand Kit
Under Logos, add variants with logo files, background colors, and usage instructions. Define sizes and logo usage rules.
Under Colors, build palettes with named groups and individual colors. Add color usage rules.
Under Typography, register fonts with usage context and font file uploads. Define your type scale. Add typography usage rules.
Create use-case templates such as Hero Image, Data Visualization, and Quote Card. Add instructions and reference examples to each template.
Save your changes
Tip: You can populate Visual Guidelines via MCP from your brand guidelines or visual assets. Learn more about the Brand Kit MCP →
Example
A company might configure their Visual Guidelines like this:
Logos: Four variants for different surfaces (light, dark, forest green, neon green). Multiple size tiers from large (hero sections) to minimum (footers and favicons). Rules covering clear-space, no stretching, and background pairing.
Colors: Five palettes covering core brand, text hierarchy, strokes, dark mode, and a dedicated chart palette. Rules enforcing sharp corners everywhere and flat fills for charts.
Typography: Three typefaces with hosted font files. A serif for headlines, sans-serif for body, monospace for labels. A full type scale from Display down to Caption. Rules restricting serif to headlines and requiring all-caps monospace for labels.
Use-case templates: A Hero Image template with editorial illustration guidance and landing-page references; a Data Visualization template with chart examples and layout rules; and a Quote Card template with typography, attribution, and logo-placement guidance.
Section Details
Logos
Logo Variants
Define different versions of your logo for different background contexts.
Name
A descriptive name for this variant (e.g., "Full Color on White," "White Reversed on Near Black").
Background Color
The hex color this variant is designed for (e.g., #ffffff, #002910).
Usage Instructions
When and how to use this variant. Include clear-space rules, restrictions, and background pairing logic.
Logo File
Upload your logo image (SVG, PNG, JPG, GIF, or WebP).
Logo Sizes
Define allowed rendering sizes so AI tools never render your logo too small or too large.
Name
A label for this size tier (e.g., "Large," "Minimum").
Width
Width in pixels (optional if height is set).
Height
Height in pixels (optional if width is set).
Usage Instructions
Where this size should be used (e.g., "hero sections," "footers").
Logo Usage Rules
Freeform rules governing logo treatment.
Rule
The rule text (e.g., "Minimum clear space equals the height of the A on all sides," "Never stretch, rotate, or recolor the logo").
Colors
Color Palettes
Group your brand colors into named palettes. Each palette contains individual colors with hex values and usage instructions.
You can create multiple palettes to separate concerns, for example: Primary, Text, Strokes, Dark Mode, and Charts.
Palette Name
A name for this group of colors (e.g., "Primary," "Charts").
Color Name
A descriptive name for each color (e.g., "Interaction Green," "Text Secondary").
Color Value
The hex value (e.g., #00ff64).
Usage Instructions
When and where to use this color (e.g., "hover states and interactive accents," "captions and metadata").
Color Usage Rules
Freeform rules governing color usage.
Rule
The rule text (e.g., "All large surfaces must use dark green #002910," "Sharp corners only, border-radius: 0," "Data viz: flat fills only, no gradients").
Typography
Fonts
Register the typefaces your brand uses.
Name
The font name exactly as it should be referenced (e.g., "Saans," "Serrif VF").
Usage Instructions
Which contexts this font applies to, fallback fonts, and platform-specific substitutes.
Google Font Link
A Google Fonts URL, if the font is hosted there.
Font File
Upload a custom font file (e.g., .woff2). Agents can load these via @font-face.
Type Scale
Define your full typographic scale by linking specific size, weight, and line-height configurations to a font.
Font
Which registered font this type size belongs to.
Name
A label for this step in the scale (e.g., "Display," "H1," "Body," "Caption").
Weight
Font weight (e.g., "400," "600").
Size
Font size in pixels.
Line Height
Line height in pixels.
Usage Instructions
Where this type size should be applied.
Typography Usage Rules
Freeform rules governing typographic treatment.
Rule
The rule text (e.g., "Serrif VF is for large editorial headlines only," "Monospace labels must always be all-caps, 11-12px, weight 500").
Use-case templates
Create a separate template for each kind of visual asset your team produces. Each use case carries its own instructions and examples, so an AI tool can retrieve guidance that matches the requested output instead of interpreting a flat dump of unrelated images.
Common templates include:
Hero Image: Composition, aspect ratio, subject treatment, illustration or photography style, and examples of successful hero art.
Data Visualization: Chart palette, labeling, grid and axis treatment, annotation style, and examples of on-brand charts.
Quote Card: Typography hierarchy, attribution placement, background treatment, logo placement, and examples of approved social cards.
Add other use cases for the assets your team creates, such as product screenshots, report covers, or presentation title slides. For each one, provide:
Instructions that describe the intended composition, style, required elements, and patterns to avoid.
Examples that show the use case applied successfully and give an AI tool a concrete visual reference.
Use the structured Logos, Colors, and Typography sections for rules that apply across every asset. Keep template instructions focused on what is unique to that visual use case.
FAQ
How do I access Visual Guidelines in my AI tools? Visual Guidelines are available through the Brand Kit MCP. Connect it to Claude, Cursor, or any MCP-compatible tool to read and write your visual identity programmatically. Workflow Liquid variables are not yet available for Visual Guidelines fields.
Can I populate Visual Guidelines using AI? Yes. Using the Brand Kit MCP, you can have Claude read your existing brand guidelines PDF and write the structured fields directly into your Brand Kit.
What use cases does this unlock? Any AI tool connected via MCP can retrieve your visual identity to produce on-brand reports, slide decks, one-pagers, and data visualizations with your exact colors, fonts, and rules.
What's the difference between use-case instructions and the other structured guidance? A template's instructions describe how to produce one kind of asset, such as a Hero Image or Quote Card. Field-level instructions explain when to use a particular logo, color, or font, while category usage rules set broader guardrails that apply across all assets.
Last updated
Was this helpful?