Milly Software
InsightsEngagementAnglers, Not Fishermen: Brand Voice and Brand Dictionary for Shopify AI Chat
Engagement··6 min read

Anglers, Not Fishermen: Brand Voice and Brand Dictionary for Shopify AI Chat

Two fields that let a marketing team shape how a Shopify AI chat widget sounds — Brand Voice for persona, Brand Dictionary for exact terminology — kept separate from the developer-owned AI Instructions safety rails.

V
Viet Le
co-founder · Milly Software

If you sell fishing gear, your customers are anglers — not fishermen. You've probably spent years getting that right across product copy, email, and packaging. Then you add an AI chat widget, and the first thing it does is cheerfully tell a shopper that "this jacket is great for fishermen." One word, but it's the kind of word a brand notices.

That gap is what Brand Voice and Brand Dictionary close. They're two fields on Configure → Response that let the people who own your brand voice shape how the AI sounds — without touching the rules that keep it accurate and safe.

Why we split this out of AI Instructions

Until this shipped, anything you wanted the AI to know went into a single AI Instructions box. That box was doing three unrelated jobs at once: enforcing hard rules ("never recommend a competitor," "always check stock before promising availability"), setting tone ("be warm and concise"), and fixing vocabulary ("say anglers"). Three jobs, three different owners, three different change cadences — all tangled in one textarea.

The hard rules are really product and engineering's concern. They change rarely, and a mistake there is a correctness problem. Tone and vocabulary belong to marketing. They change as the brand evolves, and a mistake there is an identity problem, not a bug. Keeping all of it in one field meant a marketer couldn't adjust the voice without reading past the safety rails — and nobody wanted to hand the safety rails to whoever was tuning the tone that week.

So we pulled the identity half into two purpose-built fields that sit alongside AI Instructions, not inside it.

Brand Voice — the persona

Brand Voice is a short description of how your store should sound, and it gets layered into every response the AI generates. It's not a script — you're not writing the answers, you're describing the speaker. A few examples of the altitude it works at:

  • "Friendly and outdoorsy. Talks like a guide on the trail, not a salesperson."
  • "Expert and concise. Assumes the customer knows the category and respects their time."
  • "Warm and a little playful, but never gimmicky."

The AI already writes competent, neutral answers out of the box. Brand Voice is what bends those answers toward sounding like you specifically — the difference between a correct response and one a shopper wouldn't be surprised to get from your team.

Brand Dictionary — the exact words

Brand Voice handles tone; Brand Dictionary handles precision. It's a list of preferred terminology and substitutions the AI honors verbatim — the words you always use and the words you never do.

  • "Call them anglers, never fishermen."
  • "It's the Pro Series, not the premium line."
  • "We say members, not customers."

These are the rules that are too specific for a tone description and too small to feel like they belong next to "never recommend a competitor" — but they're exactly the kind of detail a brand team will notice the AI getting wrong. A dictionary entry is a precise lever: the substitution applies every time, across every format.

How it's wired

Both fields feed the system prompt at the moment a response is composed, so they apply to every answer the AI gives — product recommendations, knowledge-base replies, lead-capture prompts, all of it. There's nothing to wire up on the storefront and no per-message tagging; you edit the two fields on Configure → Response and the change takes effect on the next conversation.

Because they live outside AI Instructions, a marketing team can iterate on voice and vocabulary on its own cadence without ever opening the safety rails — and the person who owns those rails doesn't have to review a tone tweak to make sure nothing load-bearing moved. Different owners, different fields, no collisions.

Who this is for

This is the feature for the merchant who cares that the AI is theirs, not just accurate. Accuracy is table stakes — the widget reads your real catalog and your real knowledge base, so it doesn't make things up. Brand Voice and Brand Dictionary are the layer on top: making sure the thing it says correctly, it also says the way you would.

Both fields are available on Essentials and up, and they ship to every merchant now that Milly Chat is live on the Shopify App Store.

A chat widget that gets the facts right but the voice wrong still reads as a bolted-on robot. The point of these two fields is that the AI should sound like it came from your brand — down to the word anglers.

If there's a turn of phrase your brand lives or dies by and you're not sure how to encode it, drop us a note — we're happy to help you set it up.

Frequently Asked Questions

What's the difference between Brand Voice and Brand Dictionary?

Brand Voice sets the persona — a short description of how your store should sound that gets layered into every response the AI generates. Brand Dictionary sets precision — a list of preferred terminology and substitutions the AI honors verbatim, like 'call them anglers, never fishermen.' One shapes how the AI sounds; the other pins the exact words it uses.

How are these different from the AI Instructions field?

AI Instructions holds the hard rules that keep the AI accurate and safe — things like 'never recommend a competitor' or 'always check stock before promising availability' — which are really product and engineering's concern. Brand Voice and Brand Dictionary were split into their own fields so a marketing team can iterate on tone and vocabulary on its own cadence without ever touching those safety rails.

Do I need to change anything on my storefront to use Brand Voice or Brand Dictionary?

No. Both fields feed the system prompt at the moment a response is composed, so they apply to every answer — product recommendations, knowledge-base replies, lead-capture prompts — with no storefront wiring and no per-message tagging. You edit the two fields on Configure → Response and the change takes effect on the next conversation. Both are available on Essentials and up.

Try Milly Chat

Want to see how this fits your store?
We'll set up a working session.

Get it on ShopifyTalk to sales →