Office & business

Confluence: Create a glossary

Without any extra add-ons: This automatically turns definitions into a glossary

In larger (IT) companies you often cannot avoid the Atlassian product range. On the one hand, the wiki software Confluence is quite flexible, on the other hand it lacks all kinds of features that you would expect as a standard - such as automatic linking of words or a real glossary. High sums quickly become due for corresponding add-ons if billing is based on users. But it's also possible without it.

Glossary concept

If you are already familiar with Confluence, the concept in brief might be enough:

  • Create page for the definition
  • Mark definition as excerpt
  • Give the label "glossary".
  • Create a page for the glossary
  • List titles and excerpts from pages labeled “glossary” using a macro

Of course, you can also work with multiple labels here. In any case, at the end there is a glossary that is automatically expanded when a new definition is created. The whole thing also works across spaces.

And now the whole procedure step by step.

1. Create definition

For a first Glossary entry you create a page with the term as Title, which should also appear in the glossary. Then you write it Definition even.

text in confluence.
The page title later becomes the glossary entry

Marked then the text and calls the macro Excerpt to mark the definition as an excerpt.

Select excerpt macro.
Highlight text, apply "Excerpt" macro

Now put a label glossary - or whatever you want to use (via the small note icon at the top right next to the breadcrumbs). This completes the definition page.

label in atlassian confluence.
Pages can be filtered using labels

2. Create a glossary

Now create a page for the glossary and call the macro Content by label on. Select the glossary label and the standard view appears in the preview:

content-by-label macro in use.
The filter for glossary pages, here without any further options

You can then use the options to activate the excerpt display and, if necessary, hide labels and spaces.

confluence glossary preview.
The preview including excerpts and without labels and spaces

From now on, all excerpts from pages with the set label will appear in the glossary.

a glossary in confluence.
The "ready" glossary in Confluence

By the way: The excerpts can also be inserted manually, which can be used as a small text module system.

Product prices and availability are correct as of the date/time shown and are subject to change. All pricing and availability information on at the time of purchase applies to the purchase of this product.

Mirco Lang

Freelance journalist, Sauerland exile, (fairly old) skateboarder, graduate computer scientist, retail salesman, open source nerd, Checkmk handbook writer. Ex-Saturn'ler, Ex-Data-Becker'ler, Ex-BSI'ler. First contact with computers: ca. 1982 - a friend's big brother's C64. If you want to read more about open source, Linux and craft stuff and support Tutonaut here: About Coffee sponsorship via Paypal.I'm always happy. In advance: Thank you! Do not miss: and New: Mastodon

Leave a Comment

Your e-mail address will not be published. Required fields are marked with * marked

This website uses Akismet to reduce spam. Learn more about how your comment data is processed.

Back to Top button


Please deactivate your ad blocker.