Skip to main content

Add and edit terms

Use the Glossary page of a space to add a term, give it other spellings and translations, change it or delete it.

Who can do this: editor of the space, see Permissions.

Before you start​

The glossary of the space must be set up, and you must be one of its editors. If you do not see the Add new button, ask a space admin to add you to Editors.

Steps​

Add a term​

  1. Open the space and choose Glossary in the space navigation, under Apps.
  2. Click Add new. The Term editor opens.
  3. In Term, enter the name of the term.
  4. In Alternative forms: synonyms, abbreviations, variations, enter the other ways the term is written, for example a plural or an abbreviation. Use a comma to separate values.
  5. In Definition, write the explanation readers will see. You can format the text: bold, lists, links.
  6. Optional: in Labels, pick existing labels or type a new one and choose Add new.
  7. Click Submit.

The fields are described in Space page.

Add the term in another language​

The Term editor has one tab for each of the Allowed languages of the space.

  1. Open the tab of the language.
  2. Fill in Term and Definition for this language, and Alternative forms if you need them.
  3. Click Submit.

Clear empties the fields of the language you are on.

Change or delete a term​

  • To change a term, click the Edit button on its card, change the fields and click Submit.
  • To delete a term, click the Delete button on its card and confirm with Delete.

Result​

The term appears in the list as a card with its name, alternative forms, definition and labels. The card is shown in the main language of the space. If the term has more than one language, the card has a language selector.

Good to know​

  • Name and definition are required. If you enter a name without a definition, the editor asks you to fill in the value for that language and does not save the term.
  • A name can be used only once in a glossary. If another term already has this name, the editor shows an error with the name.
  • An alternative form can belong to only one term. If it is already used by another term, the editor shows an error with that word. The same happens if you enter one alternative form twice in the same term.
  • Do not repeat the name of the term among its alternative forms. The name is already used to find the term.
  • Cancel saves nothing. A term is created or changed only when you click Submit.
  • The list is sorted by name. Letter case does not matter and numbers are compared as numbers, so Term 2 comes before Term 10.
  • Alternative forms matter for readers. The app finds a term in page text only by its exact name or alternative forms, see How terms are found in text.