How to Build a Business Glossary That People Actually Use
A business glossary is one of the most fundamental components of data governance. It’s also one of the most frequently attempted and most commonly abandoned. The pattern is depressingly familiar: a governance team spends three months defining 500 business terms, publishes them in a spreadsheet or wiki, announces it to the organisation, and then watches adoption flatline within weeks.
The glossary becomes a monument to effort rather than a living resource. Meanwhile, business users continue using inconsistent terminology, analysts continue making assumptions about what “active customer” means, and the same definitional arguments happen in every meeting.
Here’s how to break that cycle.
Why Glossaries Fail
Understanding the failure modes is the first step to avoiding them.
Scope creep. The team tries to define every term in the organisation simultaneously. This produces a massive, overwhelming document that nobody wants to read and nobody can maintain. A glossary with 1,000 terms of mixed quality is less useful than one with 50 terms that are rigorously defined and actively referenced.
Academic definitions. Terms are defined with formal precision that’s technically correct but practically useless. “Revenue: The total amount of income generated by the sale of goods or services related to the company’s primary operations” tells a business analyst nothing about how revenue is calculated in the specific systems they use.
No ownership model. Terms are defined once and never updated. Business evolves — new products launch, customer segments change, regulatory definitions shift — but the glossary remains static. Within a year, it’s outdated enough to be actively misleading.
Disconnected from workflows. The glossary lives in a separate tool or document that users have to actively seek out. If people need to leave their analytics platform, find the glossary, search for a term, and then return to their work, they won’t do it. Convenience wins every time.
A Better Approach
Step 1: Start With Conflict Terms
Don’t try to define every business term. Start with the terms that cause actual problems — the ones that different teams define differently, leading to conflicting reports, miscommunication, and wasted time.
Every organisation has these. Common examples:
- “Customer” — Does this include trial users? Past customers? B2B accounts versus individual users?
- “Revenue” — Gross or net? Including or excluding refunds? Recognised or billed?
- “Active” — Active in the last 30 days? 90 days? Ever logged in?
- “Region” — Based on billing address? Shipping address? IP location?
Identifying these conflict terms is straightforward: ask the analytics team, the finance team, and the sales team to each define your five most important business metrics. Where their definitions diverge, you’ve found your starting point.
Step 2: Define Operationally, Not Academically
Each term in the glossary should answer three questions:
- What does this term mean in plain language? (One or two sentences, no jargon)
- How is this calculated or determined in our systems? (Specific logic, SQL if appropriate, source system references)
- What does this term NOT include? (Explicit exclusions prevent the most common misunderstandings)
Example:
Active Customer A customer who has logged into their account at least once in the last 90 days. Calculated from the
users.last_login_atfield in the production database. Excludes admin accounts, test accounts, and users with astatusof “suspended.” Note: The marketing team’s “engaged customer” metric uses a 30-day window and includes email opens — this is a different measure.
That last line — explicitly noting related but distinct terms — prevents the exact confusion that makes glossaries necessary in the first place.
Step 3: Assign Owners, Not Authors
Every term needs a named owner — a specific person (not a team, not a role) who is responsible for the definition’s accuracy and currency. When someone disputes a definition, the owner resolves the dispute. When business changes affect the definition, the owner updates it.
Term ownership should sit with business subject matter experts, not the governance team. The governance team facilitates, maintains the platform, and ensures consistency. But the person who understands what “customer churn” means in operational terms is a business leader, not a data steward.
Step 4: Embed in Workflows
The glossary must be accessible where people work. This means:
- In BI tools. Modern data catalogues can surface glossary definitions alongside dashboards and reports. When an analyst hovers over “Monthly Active Users” in a Tableau dashboard, the definition should appear.
- In SQL editors. Column-level metadata linked to glossary terms helps analysts writing queries.
- In documentation. Standard report documentation should reference glossary terms rather than re-defining metrics from scratch.
- In meeting templates. When someone presents data in a meeting, the glossary definition of key terms should be accessible (ideally linked) in the presentation.
The DAMA-DMBOK recommends this integration approach, and the organisations that follow it consistently report higher glossary adoption than those that maintain standalone glossary documents.
Step 5: Review Quarterly
Set a quarterly review cycle. Each quarter, term owners confirm that their definitions are still accurate, the governance team removes deprecated terms, and new conflict terms identified through data quality issues or stakeholder feedback are added.
This review shouldn’t take more than an hour per quarter if the glossary is properly scoped. If it takes longer, the glossary is probably too large.
Measuring Success
A business glossary’s success should be measured by adoption and impact, not by size.
Useful metrics:
- Number of unique users accessing the glossary monthly
- Reduction in “definitional” questions to the analytics team
- Number of data quality incidents traced to terminology confusion (should decline over time)
- Percentage of key reports linked to glossary definitions
Vanity metrics to avoid:
- Total number of terms defined (more isn’t better)
- Glossary “completeness” percentage (unmeasurable and misleading)
Start This Week
If your organisation doesn’t have a business glossary, you can start one today. Open a shared document. Write down the ten business terms that cause the most confusion. Define each one using the operational format described above. Share it with your analytics and business teams. Ask for corrections.
That document — imperfect, incomplete, and probably wrong in a few places — is more valuable than a comprehensive glossary that takes six months to build and never gets used.
Governance is built in increments, not grand gestures.