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.
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).
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 https://api.crystallize.com/your-tenant-identifier/catalogue for more information.
