Compliance Glossary for Confluence

How do I manage a controlled vocabulary in Confluence?

Create each controlled term as a governed record with a required name and definition. Scope it to one space or All spaces. Add category, synonyms, owner, review dates, and notes as needed. Move it from Draft to In Review, then have a different eligible administrator approve it. Only Approved terms appear in the page glossary and inline term macros.

Last verified against production v6 · 26 September 2026

At a glance

InputActionOutputLimit
Term Name and DefinitionSelect SaveVersion 1 in DraftAn active license and term-manager access are required
Space, category, synonyms, owner, and datesStore governed contextScoped term recordA space sees approved terms in its effective glossary only
Draft term and change reasonSelect Submit and confirmIn Review termSubmission does not approve the term
In-review term and approval reasonA separate eligible administrator selects ApproveApproved term and new versionCreator, editor, or submitter cannot approve the same content
Existing term and change reasonSelect Edit, then SaveUpdated version and History recordAn approved edit does not automatically return to review

How it works

  1. Open Compliance Glossary for Confluence.
  2. Select + New Term.
  3. Complete Term Name, Definition, and Space.
  4. Add ownership, review dates, synonyms, and notes when needed.
  5. Select Save.
  6. Select Submit and record the reason.
  7. Ask a different eligible administrator to select Approve.
  8. Use History to review recorded versions and reasons.
  9. Add the Compliance Glossary or Glossary term macro to a page.

Example

A legal team defines “Material incident” for its space. The owner adds the approved meaning, synonyms, and review date. Another administrator approves it. The Compliance Glossary macro then shows that meaning on Legal pages and in subscribed spaces.

What this does not mean

The app governs term records and their publication. It does not decide the correct legal meaning. Editing requires a reason and creates a version. However, editing an approved term does not automatically send it back to review. Teams that require reapproval must select Send for Review before the controlled change process.

Related questions

Next step

Create the first term, assign its scope, and send it to an independent reviewer.

View on Atlassian Marketplace
Verification basis: production v6 code, tests, manifest, and operations guidance. Verified 26 September 2026.