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
- Open the page in the Confluence editor.
- Type
/Glossarywhere the table should be and choose the Glossary macro. The table appears in the editor with the terms of the space. - Select the macro and click the edit button in its toolbar to open the settings.
- In Name, enter the caption of the table.
- In View mode, choose All for every term of the space, or Only on page for the terms used on this page.
- Optional: in Labels, choose labels to show only the terms that have them.
- Optional: choose the Language of the table, and turn on the extra columns: Alternative forms, Labels, Global term.
- 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.