Skip to main content
More in Learn

Selection Component

With the selection component, you can set up a predefined set of options and configure any number of them to be selected. By setting up a list of choices, you limit the choices for the item editor, ensuring data consistency and improving editing flow.

Selection Component Usage

When adding this component to a shape or piece, specify a name (required) and description (optional) indicative of the sort of content you wish for it to contain. This description will be visible to those who build content based off of this shape. Optionally, you can specify a minimum/maximum number of values that must be selected, and can preselect values as well. A value that’s preselected cannot be deselected later.

This component is not translatable, meaning that the same key/value pairs will be stored for all translations. It’s best to use non-translatable fields for data that will be the same regardless of language (like model numbers, for instance).

Selection component on shape
Edit selection component

Catalogue API Access

Once created, selection components and their content are accessible via the Catalogue API. Refer to our sample query for retrieving selection component content, and to the API docs at for more information.

People showing thumbs up

Need further assistance?

Ask the Crystallize team or other enthusiasts in our slack community.

Join our slack community