> ## Documentation Index
> Fetch the complete documentation index at: https://docs.customei.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Groups and layout

> Break a long list of questions into sections, move options around, and add a divider between them.

An option set with thirty questions in one column is the fastest way to lose a shopper. Groups, dividers and a little reordering turn the same set into something that reads like a short form.

## Group a few options together

Click the folder icon in the option list toolbar to add a group. A group is an option in the list like any other, except it holds the ones you put inside it.

<Frame caption="Group settings. A group has a label and two display choices.">
  <img src="https://mintcdn.com/nexlify/EU53-heGhju2TXgk/images/optionsets/group-settings.png?fit=max&auto=format&n=EU53-heGhju2TXgk&q=85&s=9dfa14a2f15ed4cc3d1197201aaa859b" alt="The option set editor with the Edit group card outlined, showing Group label, Display mode set to Collapsible and Default state set to Expanded." width="3840" height="2400" data-path="images/optionsets/group-settings.png" />
</Frame>

| Setting           | What it does                                              |
| ----------------- | --------------------------------------------------------- |
| **Group label**   | The heading the shopper reads                             |
| **Display mode**  | How the group behaves on the product page                 |
| **Default state** | Whether it starts open or closed, on the collapsible mode |

Three display modes:

| Mode            | On the product page                                             |
| --------------- | --------------------------------------------------------------- |
| **Collapsible** | A heading the shopper clicks to open and close                  |
| **Flat**        | Just a heading with the options under it, always open           |
| **Tabs**        | The group's sub-groups become tabs the shopper switches between |

<Tip>
  For a product with two people on it, meaning two names, two hairstyles and two outfits, make one group per person and set them to **Collapsible**, with the first one **Expanded**. The shopper finishes person one, closes it, and the form suddenly looks short.
</Tip>

A group has no **Template connections** card, because a group does not change the artwork. It only arranges the options that do.

## Putting options into a group

Hover any option row and two icons appear on the right: **...** and a bin.

<Frame caption="The row menu on an option.">
  <img src="https://mintcdn.com/nexlify/EU53-heGhju2TXgk/images/optionsets/option-row-menu.png?fit=max&auto=format&n=EU53-heGhju2TXgk&q=85&s=2054046f88df4adb43f50b2e2e0223ea" alt="An option row menu showing Duplicate, Move, and a Move to group section listing Group 1." width="286" height="362" data-path="images/optionsets/option-row-menu.png" />
</Frame>

| Action                | What it does                                                 |
| --------------------- | ------------------------------------------------------------ |
| **Duplicate**         | Copies the option, with its settings, choices and conditions |
| **Move**              | Sends it to a numbered position in the list                  |
| **Move to group**     | Drops it inside one of your groups                           |
| **Remove from group** | Appears once the option is in a group, and takes it back out |

You can also drag a row by the handle on its left. For a big jump, **Move** is easier than dragging past twenty rows.

<Frame caption="Move asks for a position number rather than making you drag.">
  <img src="https://mintcdn.com/nexlify/EU53-heGhju2TXgk/images/optionsets/move-to-position.png?fit=max&auto=format&n=EU53-heGhju2TXgk&q=85&s=762b88e5bde7d9ec3d9ba04cc993d431" alt="The Move to position panel with a number box containing 30, the hint Enter a number between 1 and 31, and Cancel and Done buttons." width="512" height="360" data-path="images/optionsets/move-to-position.png" />
</Frame>

On a **group** row the menu is different: **Add sub-group** (a group inside this group, which is what the Tabs mode needs), **Ungroup** (dissolve the group and leave its options in place), and **Duplicate**.

<Warning>
  The order of options in the list is the order your shopper meets them. Put the choices that change the artwork the most near the top. Shoppers who see the design react to their first answer will keep going.
</Warning>

## A divider between sections

**Divider** is an option type that asks nothing. It draws a labelled break in the form, for when a group would be too heavy.

<Frame caption="Divider settings, with nine ready-made styles.">
  <img src="https://mintcdn.com/nexlify/EU53-heGhju2TXgk/images/optionsets/divider-settings.png?fit=max&auto=format&n=EU53-heGhju2TXgk&q=85&s=a22d60276332448df830db12d07bcab9" alt="The option set editor with the divider settings card outlined, showing nine style previews named Line, Gradient banner, Solid bar, Pill, Tab, Underlined heading, Ornament, Soft callout and Double line, plus Icon, Accent colour, Label alignment, Line style and Line thickness." width="3840" height="2400" data-path="images/optionsets/divider-settings.png" />
</Frame>

Pick a **Style**, type the wording in **Divider label**, and set an **Accent colour** to match your shop. **Icon** puts a small symbol beside the label, and choosing *custom* there lets you upload your own. An animated GIF works and keeps its movement.

The **Line style** and **Line thickness** settings only apply to the styles that actually draw a rule. Under **More settings** you can also set the label colour and force the label to uppercase.

## Rearrange the three panes

The option-set screen has three panes: the option list, the option being edited, and the preview. **Edit layout** at the top right lets you drag them into the order you like.

<Frame caption="Edit layout mode. Drag a pane, then click Done.">
  <img src="https://mintcdn.com/nexlify/EU53-heGhju2TXgk/images/optionsets/edit-layout.png?fit=max&auto=format&n=EU53-heGhju2TXgk&q=85&s=528115af5f57ddd69e0aaa5bfef9c34a" alt="The option set editor in edit layout mode, with Reset to default and Done in the header and the preview pane outlined as a draggable block." width="3840" height="2400" data-path="images/optionsets/edit-layout.png" />
</Frame>

Click **Done** to keep the arrangement, or **Reset to default** to put it back. This only changes what you see in the admin. Your shopper's product page is unaffected.

## Where to next

<CardGroup cols={2}>
  <Card title="Show an option only when it matters" icon="eye" href="/optionsets/conditional-logic">
    Hide options until the shopper's earlier answers make them relevant.
  </Card>

  <Card title="Check your work" icon="display" href="/optionsets/preview-your-options">
    See the form the way a shopper will.
  </Card>
</CardGroup>
