Option lists

In Sitecore Content Hub™, an entity is defined by its properties and relations. Entity property types include string, boolean, integer, and so on. An entity property can also be an option list, which is a limited list of possible values for a property.

With an option list, the hierarchical structure is defined in the data whereas with a taxonomy the data is associated with a hierarchical structure. This means that using an option list results in a smaller, less complex dataset, quicker loading times, and better performance because the graph does not need to load extra information (such as relations).


For option list best practices, see Taxonomy versus option list and Option list to taxonomy migration.


You can only delete an option list when it is not used within the domain model.

To create an option list:

  1. On the menu bar, click Manage .

  2. On the Manage page, click Option lists.

  3. On the Option lists page, click + Option list.

  4. In the Option list dialog box, select the type of option list you want to create:

    • Hierarchical: creates an option list where you can build a hiearchical structure of items.
    • Flat: creates a flat option list with all items at the same level.
  5. Click Create.

  6. On the Option lists page, select the option list to add items to it.

  7. In the option list dialog box, click Add item and define an identifier and label.

  8. Repeat step 7 to add additional items.

  9. For hierarchical option lists, click the icon and drag an item beneath an existing one to build the option list structure.

  10. Click Save.


To edit the items in an option list, select the option list and modify it in the option list dialog box.

Can we improve this article ? Provide feedback