Brand guide

Make it look like Mago

Everything you need to represent Mago in articles, talks and integrations — the mark, the palette, the type system, Works with Mago badges and copy you can paste. Or grab it all at once with the button above.

The mark

An M made of conversation

The peaks of the M resolve into diamonds — chat nodes talking to each other. Everything is straight lines and 45° angles, so the mark stays sharp from a 16px favicon to a conference banner.

Core icon

The main mark. Orange gradient, engineering grid, satellite diamonds. For the app icon, marketplace listing and favicon.

mago-core-icon.svg ↓

Addon icon

For third-party skills built on Mago. Charcoal with an orange keyline — an addon orbits the core, it doesn't replace it.

mago-addon-icon.svg ↓
MagoCore

Horizontal lockup

Icon plus wordmark, for headers, docs and press. "Mago" is always bold, the product name ("Core") always light.

mago-core-horizontal.svg ↓

Breathing room: keep clear space around the mark of at least its own corner radius, and don't use it smaller than 24px on screen. Scale from the SVGs — they're the source of truth.

Color

One loud orange, everything else calm

Mago Orange#FF7A33
Deep Orange#E65000
Charcoal#373330
White#FFFFFF
Peach#FFE9DC

The rule of thumb: orange marks the brand and things you can click — nothing else. The gradient (Mago Orange → Deep Orange, 135°) lives on icon backgrounds only, never behind text.

Typography

Bold meets light

The wordmark's contrast is the whole system: DM Sans Bold against DM Sans Light. One family, two extremes.

Mago Core
DM Sans 700 + 300Wordmark & headings
Ask your store anything.
DM Sans 400Body & interface
Mago reads sales data, walks configuration trees and drafts content — then waits for your go-ahead before it writes a single thing.
DM MonoCode only
composer require mago-assistant/mago

Product naming follows the wordmark: Mago Core, Mago Analytics, Mago Content — bold brand, light suffix, never reversed.

Playing nice

A few simple rules

Lovely

  • Core icon for the product, Addon icon for extensions
  • Place the mark on charcoal, white or peach backgrounds
  • Write it as Mago — capital M, no all-caps
  • Scale from the SVG files, never from screenshots

Please don't

  • Recolor the mark or swap the gradient for another hue
  • Rotate, outline, shadow or otherwise decorate the icon
  • Put the orange gradient behind body text
  • Set the wordmark in anything but DM Sans
Works with Mago

Built a skill? Say so

Does your module ship a Mago skill? Put a badge on your product page, in your docs or in your GitHub README, so merchants know before they install. Hotlink the files below, they live at permanent URLs, or download the whole kit.

Try it on
vendor.example/checkout-pro
Checkout Pro for Magento 2
Works with Mago Works with Mago Hyvä ready
README.md
vendor/module-checkout-pro
licenseMIT magento2.4.8+ Mago compatible

Flip the background: the charcoal badge is for light sites, the orange one works on both.

Orange, large

Addon icon on Mago Orange. Works on light and dark. 163 × 68.

<a href="https://askmago.com/" title="Works with Mago"><img src="https://askmago.com/badges/works-with-mago-orange.svg" alt="Works with Mago" width="163" height="68"></a>
[![Works with Mago](https://askmago.com/badges/works-with-mago-orange.svg)](https://askmago.com/)
SVG ↗

Charcoal, large

Core icon on charcoal. For light sites. 163 × 68.

<a href="https://askmago.com/" title="Works with Mago"><img src="https://askmago.com/badges/works-with-mago-dark.svg" alt="Works with Mago" width="163" height="68"></a>
[![Works with Mago](https://askmago.com/badges/works-with-mago-dark.svg)](https://askmago.com/)
SVG ↗

Orange, compact

Text only, for product lists and footers. 160 × 36.

<a href="https://askmago.com/" title="Works with Mago"><img src="https://askmago.com/badges/works-with-mago-orange-compact.svg" alt="Works with Mago" width="160" height="36"></a>
[![Works with Mago](https://askmago.com/badges/works-with-mago-orange-compact.svg)](https://askmago.com/)
SVG ↗

Charcoal, compact

Text only, for light sites. 159 × 36.

<a href="https://askmago.com/" title="Works with Mago"><img src="https://askmago.com/badges/works-with-mago-dark-compact.svg" alt="Works with Mago" width="159" height="36"></a>
[![Works with Mago](https://askmago.com/badges/works-with-mago-dark-compact.svg)](https://askmago.com/)
SVG ↗

README: Mago | compatible

shields.io style, 20 px high. Sits next to “Hyvä Themes | compatible”.

<a href="https://askmago.com/" title="Mago compatible"><img src="https://askmago.com/badges/mago-compatible.svg" alt="Mago compatible" width="110" height="20"></a>
[![Mago compatible](https://askmago.com/badges/mago-compatible.svg)](https://askmago.com/)
SVG ↗

README: works with | Mago

shields.io style, 20 px high. The same badge, other way round.

<a href="https://askmago.com/" title="Works with Mago"><img src="https://askmago.com/badges/works-with-mago.svg" alt="Works with Mago" width="110" height="20"></a>
[![Works with Mago](https://askmago.com/badges/works-with-mago.svg)](https://askmago.com/)
SVG ↗
  • Only for modules that ship a working Mago skill
  • Always link the badge to askmago.com
  • Never recolor, stretch or decorate; scale evenly, and keep the large badges at 163 × 68 or bigger
  • On dark backgrounds use the orange variant
Download badge kit (ZIP) ↓

SVG and PNG at 1× and 2×, the two GitHub badges and a README. The URLs above are permanent, so hotlinking is safe.

For press

Copy you can paste

Short~25 words

Mago is an AI admin assistant for Magento 2. Merchants chat with their store — analytics, configuration and content — powered by Claude, OpenAI or the AI provider of their choice. Open source, MIT-licensed.

Standard~60 words

Mago brings a natural-language assistant into the Magento 2 admin panel. Merchants ask questions in plain language and get live answers on sales, products, customers and configuration, streamed in real time. Write actions always require explicit confirmation, and access follows Magento's own admin roles. Third-party modules can add their own skills without touching core. Requires PHP ≥ 8.2 and Magento ≥ 2.4.8 or Mage-OS ≥ 1.1.

Platform Magento ≥ 2.4.8 · Mage-OS ≥ 1.1 PHP ≥ 8.2 AI Claude · OpenAI Streaming real-time (SSE) License MIT