Compliance Glossary for Confluence

How do I publish a glossary on a page?

Insert the Compliance Glossary macro on a Confluence space page. It shows approved terms visible to that space. This includes terms from the page space, global scope, and subscribed source spaces. Readers see each term’s name, category, synonyms, definition, and notes. They can search the list or filter it by category.

Last verified against production v6 · 26 September 2026

At a glance

InputActionOutputLimit
Confluence page spaceAdd Compliance GlossaryApproved terms in the page’s effective glossary scopeMissing space context returns no terms.
Approved term recordRender the macroName, category, synonyms, definition, and notesDraft, In Review, and Deprecated terms are excluded.
Reader textUse Search terms…Matches in names, definitions, and synonymsSearch covers terms already loaded into the macro.
More than one categoryUse Filter by categoryTerms in the selected categoryThe category control stays hidden when only one category exists.
Inactive app licenseRead an existing macroExisting approved terms remain visible read-onlyAdministrative workflows remain license-controlled.

How it works

  1. Open a Confluence page in edit mode.
  2. Insert the Compliance Glossary macro.
  3. Publish or update the page.
  4. Confirm the header shows the expected approved-term count.
  5. Use Search terms… to find a name, definition, or synonym.
  6. Use Filter by category when the glossary contains several categories.
  7. Check the footer for the current space key and subscribed-source scope.

Example

An operations page belongs to the OPS space. OPS subscribes to the LEGAL glossary. The macro shows approved OPS terms, approved global terms, and approved LEGAL terms. It excludes an HR term because OPS does not subscribe to HR. A reader searches “incident” and sees the approved meaning and synonyms.

What this does not mean

The macro is read-only. It does not create, edit, submit, or approve terms. It does not show lifecycle actors or approval timestamps. It fails closed when the page has no valid space context. Use the administrator view for governance and audit evidence.

Related questions

Next step

Add Compliance Glossary to one governed page. Confirm its space scope and approved-term count before wider use.

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