Skip to main content
More in Learn

Multiple Choice Component

The multiple choice component has the same functionality as the choice component, but with the repeating capability of a chunk. It can contain non-structural components and/or pieces among its options, which allows for powerful, flexible polymorphic content.

Multiple Choice Component Usage

When adding this component to a shape or piece, specify a name, then click and drag components and/or pieces (if defined) to add them to the multiple choice component. You can click and drag to reorder components/pieces, or use the action button (...) to delete them.

Below is an example of a "flexible hero" element that will allow content editors to arrange banners, images, and videos as desired for each product based on this shape.

Multiple choice component on shape

When editing an item based on this shape, click the button for the desired choice. The choice buttons will persist, allowing you to choose again if desired. Hovering your mouse over a chosen component will reveal buttons that allow you to add a new choice above this one, click and drag to reorder, or remove the chosen component. The action button (...) on the multiple choice component's frame allows you to remove all components. Once removed, a component's data is lost, so proceed carefully with deletion.

Editing multiple choice component on product

Nesting With Multiple Choice

Multiple choice components come with a powerful nesting capability that mirrors that of the choice component. 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.

4-level nesting schema

The screenshot below shows an example of nested structures for flexible marketing content.

Multiple choice nesting example

Catalogue API Access

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

Check Out Our Multiple Choice Component Livestream

People showing thumbs up

Need further assistance?

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

Join our slack community