Guides · November 4, 2026 · 2 min read
How to maintain a storefront terminology glossary
A customer should not need to learn your internal vocabulary to shop.
By Polo Themes

A customer should not need to learn your internal vocabulary to shop. If the navigation says “frames,” a filter says “spectacles” and support calls them “optical units,” the store may be using three labels for one concept. A small glossary makes those choices deliberate.
Collect words from actual surfaces
Read navigation, collection headings, product options, cart labels and support replies. Record terms that describe the same thing differently. Include abbreviations and supplier codes, but do not assume the shortest word is the clearest one.
For each concept, choose a preferred customer-facing term, an internal definition and acceptable alternatives. The definition matters: two people may use “bundle” to mean either a fixed set or a customer-selected group. Resolve that difference before enforcing a label.
Keep brand names and functional labels distinct
A poetic color name can remain part of the brand while a plain-language description helps recognition. For example, an invented shade name can be accompanied by “dark blue” if that description is accurate. Do not replace the official variant identifier in the order workflow unless the operational mapping is preserved.
Functional controls should explain what happens. A collection link, a product-option label and a story heading need not sound identical. The glossary governs meaning, not a requirement to repeat the same sentence everywhere.
Test a small vocabulary change
Choose one ambiguous term and follow it through a shopping task. Ask a colleague unfamiliar with the catalog what they expect the term to mean before showing the destination. Record the mismatch rather than coaching them toward your intended answer.
Update the relevant surfaces together. Renaming a collection heading while leaving the old navigation label may create more confusion. Check search synonyms separately in the tools you actually use; a written glossary does not configure search behavior by itself.
Give the glossary an owner
New products and suppliers introduce new language. Make terminology review part of adding a product family, and keep a short explanation for contested choices. When support repeatedly translates the same label for customers, bring that example back to the glossary.
The result should fit on a practical working page. Start with the words that cause mistakes, then expand only when another real ambiguity appears.
Continue with Product-page content debt: how to choose what to fix first.
