Nuxeo Server

How to Add a New Vocabulary

Updated: March 18, 2024

No cache for Studio-created vocabularies

Please be aware there is no cache enabled by default when creating a new vocabulary in Studio (see NXS-2504).

In order to set up a cache, follow the steps described in How to Configure a New Directory Cache.

Studio allows you to declare new vocabularies that can be used in the different document layouts to fill in metadata or in virtual navigations.

A vocabulary is a list of labels that are used in the application to populate the various selection lists (drop-down, select or multi-select lists). A vocabulary can be used independently or it can be associated with other vocabularies to compose a multi-level list.

There are 3 types of vocabularies:

  • Simple vocabulary: one-level vocabulary,
  • Hierarchical vocabulary: multi-level vocabulary.
  • Child vocabulary: one-level vocabulary used as the sub-level of simple vocabulary to compose a multi-level selection. To make parent selection easier, available vocabularies values are proposed in a drop down list.

    The association of simple and child vocabularies to compose a multi-level list has been replaced by the hierarchical vocabulary, which we recommend for multi-level lists.

Creating a New Vocabulary

  1. Click on the Vocabularies item of the Studio menu.

    For an exhaustive presentation of the vocabulary configuration, see the Vocabularies page.

  2. Click on the New button.
  3. Fill in the ID and vocabulary type and click on the Next button.
  4. Fill in the values as desired.

    Click on Import CSV to import content from a .csv file instead of typing each entry manually. See example files: simple-vocabulary.csv and hierarchical-vocabulary.csv.

  5. Click on the Save button. You can now use the vocabulary on layouts to populate drop-down lists. After you deploy your customization on your Nuxeo Platform, the vocabulary is available in the Admin Center so power users and administrators can easily add new entries to the vocabulary.