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, you can specify the following:
- Name (required) - A name for the component.
- Identifier - String that will be generated based on the component name when shape/piece is created or updated. You’ll use the identifier to reference the component programmatically.
- Description - An optional description of what the component should contain. This will be visible to anyone who adds content to the component later.
- Localized Content - If Yes, then you can specify different selections for each language set up within your tenant. If No, then the same selections will be shared across all languages.
- Min/Max - Optionally set minimum and/or maximum limits on the number of values that must be selected.
- Options - Specify your own key/value pairs, and whether or not they should be preselected. A value that’s preselected cannot be deselected later.


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.