Skip to Content
DocsCategories

Categories

Use categories to group articles, events, event series, services, references, and products.

A category is a record with a title, colour, description, and image, such as “Workshops”. It groups content through category tags: a content item belongs to the category when one of its own category tags matches one of the category’s tags. Creating a category does not create a public menu item.

Admin path: Content > Categories
Routes: /categories and /category/{id}

How category tags connect content

Each content form has a Category tags field. The category record has a field with the same name.

  • On a content item, it lists the category tags the item carries, such as “workshop”.
  • On a category, it lists which category tags this category stands for.

The item belongs to the category when the two lists share at least one tag. A category without category tags matches no content. The category’s title on its own does not connect anything.

For example, the “Workshops” category might have the tags “workshop” and “masterclass”. Every article or event tagged with either one belongs to “Workshops”.

When you type in a category tags field, it suggests category tags already used on content. To add a new tag, type it and press Enter.

Create a category

  1. Open Content > Categories.
  2. Select Add category.
  3. Enter the Title.
  4. Choose the Colour, in #xxxxxx format.
  5. Write the Description.
  6. Add the Category tags this category should cover. Usually include the title’s wording.
  7. Add the Image.
  8. Select Save.

The title, colour, description, and image are required.

💡
Tip

Before adding one, check the list for an existing category with the same meaning. “Workshop” and “Workshops” can split content across two groups by mistake. Use the public wording your organisation has agreed on, and spell tags the same way everywhere.

Categories have no publication state. A category’s colour can help distinguish it in the admin list; its use on the public website depends on the theme.

The list shows each category’s colour, title, Tags, and last update date. Select a title to edit the category.

Categories and free tags

CategoryFree tag
Managed in the Categories screen, matched through category tags.Entered in a content form’s General tags field.
Has a colour, description, and image.Has no separate record.
Supports consistent filtering and reuse.Suits one-off or flexible labels.

Use categories for stable site organisation. Use free tags only when editors do not need a managed list. A general tag with the same text as a category tag is not a category tag.

Assign content to a category

  1. Open the category and note its category tags.
  2. Open the article, event, service, or other item.
  3. In its Category tags field, add one of those tags with the same spelling.
  4. Save the content item and complete any publication action needed.
  5. Check the relevant public listing or collection.

If a filtered collection still does not show the item, compare the item’s category tags with the category’s tags character by character. Also check that the item is published and in the same language.

Delete a category

⚠️
Warning

Check which content uses the category’s tags before deleting it. Confirm the deletion only after choosing a replacement where needed.

Deleting a category removes the category record. The category tags stay on the content items, but they no longer belong to a category. If the name is simply wrong, edit the existing category instead of deleting it and creating another. Check category-dependent lists afterwards. Removing a category is not the same as unpublishing the articles or events that used it.

  • The category has at least one category tag.
  • Content that should belong to it carries one of those tags, spelled the same way.
  • Category-filtered lists show the expected items.
Last updated on