Skip to content

Improved selection of global and local categories

June 5, 2026
Identically named global and local main categories are better supported when displayed in separate trees, avoiding inconsistent assignments.

OpenCms supports global and local categories. These are always merged for a site.

  • This means that for a site there is only one category tree, which consists of global and local categories.
  • This behavior is deeply rooted in the system core.

An example:

Global categories:

general/
general/dog/
globalonly/

Local categories of the site:

general/
general/cat/
localonly/

Available categories in the site then composed:

general/
general/dog/
general/cat/
globalonly/
localonly/

It is important to note that the category general/ appears duplicated when viewed separately, but internally it is treated as one category. This also applies when categories are displayed separately as "local" and "global" for selection. To avoid confusion, it is advised to NEVER use identical local and global main categories in such displays.

If, as in the example above, identically named global and local main categories were chosen and category selection is performed via the separately displayed local and global categories, the result was sometimes unexpected. Previously, the selection was also inconsistent in certain cases, for example during category selection in list contents.

Through optimizations, the following aimprovements were made:

  • preventing inconsistent selection of categories
  • achieving a more consistent display of selected/deselected categories