Section

The container that groups options under a heading, optionally collapsible. Use it on every long form.

A container for options. It gives them a shared heading and, if you want, a single collapsible panel.

Every new option set starts with one empty Section.

What customers see

A heading with your options below it. With a collapsible style, the heading becomes a control that opens and closes the group.

Sections turn a long list of fields into a short list of groups.

Settings

Setting	What it does
Label	The heading customers read above the group. Required.
Style	Default, Expand, or Collapse. See below.
Prefix icon	An icon beside the heading, from the app's icon picker.
HTML class	A CSS class for your own styling.
Conditional logic	Show or hide the whole section, and everything inside it.

Section has no Name, no Column width, and no add-on or Personalizer settings, because it is only a container.

Style

Style	Behavior	Use when
Default	Always open, no toggle	The options inside are needed by most customers
Expand	Collapsible, starts open	Most customers want it, but you are happy for them to fold it away
Collapse	Collapsible, starts closed	An optional or advanced group most customers skip

Do not put required options inside a Collapse section. Customers who do not open the group receive a validation error about a field they never saw. Keep required options in a Default or Expand section.

Conditional logic on a section

Conditional logic on a section applies to everything inside it.

If six options should appear only when the customer selects "Personalize this item", you have two choices:

• Put the same rule on all six options, which is six rules to write and maintain.

• Put one rule on the section that contains them.

Use the second. It is faster to build, easier to read, and cannot be applied to only some of the options.

See Conditional logic.

Structuring a long form

A form with fifteen options is hard to read. The same fifteen options in four sections are much easier:

▸ Personalize your bracelet          (Expand)
    Engraving text
    Engraving font
    Engraving position

▸ Gift options                       (Collapse)
    Gift wrap
    Gift message
    Send directly to recipient

▸ Delivery                           (Default)
    Delivery date
    Delivery notes

▸ Size guide                         (Collapse)
    Size chart

The customer sees four decisions rather than fifteen fields, and opens only the ones they need.

Working with sections in the builder

Action	How
Add a section	Add section in the add picker.
Move options into it	Drag them in. Options can be dragged between sections freely.
Move a whole section	Drag the section — everything inside comes with it.
Duplicate a section	Use the section's actions menu. Everything inside is copied, with names renumbered to stay unique.
Delete a section	Removes the section and everything inside it. You are asked to confirm.

Deleting a section deletes the options inside it. To remove only the grouping, drag the options out first.

See Build your options.

Examples

Optional personalization, hidden until asked for

Setting	Value
Label	Personalize your bracelet
Style	Collapse
Prefix icon	A paintbrush
Conditional logic	Show when Add personalization is enabled
Contains	Engraving text, font, position — none required

A required group, always open

Label Choose your size, with Style set to Default, containing a required size button row.

A reference group at the bottom

Label Size guide and care, with Style set to Collapse, containing a size chart and a paragraph.

Notes

• Available on the Advanced plan.

• Works in Shopify POS.

• Sections cannot be nested inside each other.

• Every option belongs to a section. An option cannot exist outside one.

• An option set with sections but no options inside them cannot be saved.

• Sections collect nothing, so they never appear on the cart or the order.