Skip to main content

Add a glossary table to a page

Put a table of terms on a Confluence page when readers should see the definitions as part of the page: a glossary section at the end of a document, or a page with the vocabulary of one topic.

Who can do this: anyone who can edit the page, see Permissions.

Steps​

  1. Open the page in the Confluence editor.
  2. Type /Glossary where the table should be and choose the Glossary macro. The table appears in the editor with the terms of the space.
  3. Select the macro and click the edit button in its toolbar to open the settings.
  4. In Name, enter the caption of the table.
  5. In View mode, choose All for every term of the space, or Only on page for the terms used on this page.
  6. Optional: in Labels, choose labels to show only the terms that have them.
  7. Optional: choose the Language of the table, and turn on the extra columns: Alternative forms, Labels, Global term.
  8. Close the settings and publish the page.

All settings are described in Glossary Table Macro.

Result​

The published page shows a table with the columns Name and Description. Links in definitions can be clicked.

Good to know​

  • Without settings the table shows all terms of the space with their definitions. Alternative forms and labels are not shown until you turn them on.
  • Rows are sorted by name. A click on the Name column header reverses the order, the next click restores it.
  • Only on page keeps the table short. It lists only the terms that are found in the text of the page.
  • The label filter gives a glossary of one topic. A table set to a label shows only the terms with that label.
  • Terms that do not have the chosen language are left out. A table set to German shows only the terms that have a German version.
  • The table is exported to Word. When the page is exported, the document contains the caption, the terms and the definitions.