Choice Component

With the choice component, you can define shapes and/or pieces that allow editorial users to, for instance, manage different types of hero media like an image, video, or relation to a richer media item. This still maintains semantic integrity with all choices being grouped as hero, but the editorial user can only select one when creating the item.

To use another example: there are different sets of properties that describe a TV vs. a refrigerator. The editorial user can click on the appropriate set of properties to define during product creation.

Choice components come with a powerful nesting capability. You can add them to pieces to create sophisticated multi-level structures. Currently, four levels of nesting are supported. The diagram below shows the different combinations that are possible between pieces and structural components.

The components on the fourth level of nesting may only contain non-structural components. A non-structural component is any component that isn't a chunk or choice, such as single line or rich text. A full list of non-structural components can be found here.

The screenshots below show some examples of nested structures for product properties (food, in this case) and flexible marketing content.

Once created, choice components and their content are accessible via the Catalogue API. Refer to our sample query for retrieving choice component content, and to the API docs at https://api.crystallize.com/your-tenant-identifier/catalogue for more information.