Skip to content

Advanced Product OptionsUsing the app

Understanding option types

All option types in the app can be divided into four main categories: Single select, Multi select, Input, and Content.

The first three categories require customer interaction:

  • Single select — the customer selects one value from a list of available choices.
  • Multi select — the customer can select several values within the same option.
  • Input — the customer provides their own information, such as text, a number, phone number, date, or another type of input.

Content options work differently. They do not require any action from the customer and are used to add supporting content or structure to the product page — for example, text, spacing, visual separators, size guides, links, and other informational elements.

Below, we’ll take a closer look at each option type.

  • Radio button displays option values as small circular selectors and allows the customer to select only one value at a time. Once a radio button is selected, it cannot be cleared entirely; the customer can only switch to another value.

  • Dropdown displays option values in an expandable menu and allows the customer to select one value from a predefined list

  • Swatch displays option values as a palette of colors or images. When a customer selects a value, the corresponding swatch is highlighted as the current selection.

    This option type can also be configured as multi-select.

  • Button displays each option value as a bordered text or graphic box. Customers click a button to select one value at a time.

    This option type can also be configured as multi-select.

  • Swatch in pill displays option values as rounded, pill-shaped elements. Each pill includes a small visual swatch and the option value title. This layout is recommended for options with approximately 2–5 values.

    This option type can also be configured as multi-select.

  • Swatch card displays each option value as a separate rectangular card containing a visual swatch together with additional information such as the value title and price. This format makes it easier for customers to compare values visually and textually and is recommended for approximately 2–5 values.

    This option type can also be configured as multi-select.

  • Swatch in dropdown displays visual swatches inside a compact dropdown menu. Each swatch is shown together with its value title, allowing customers to choose from visual options while saving space on the product page. This format is recommended for options with 5 or more values.

    This option type can also be configured as multi-select.

  • Wide Image Card displays option values as large horizontal cards with enhanced visual and interactive elements. Each card can include an image, title, price, help text, link, Add/Remove buttons, and a quantity picker.

    This option type can also be configured as multi-select.

  • Tile

  • Mirrored

  • Checkbox is an input type that allows a client to select one or more options. It shows up as a square box that is supposed to be ticked/checked to be activated. It’s possible to specify the min/max selection limit for that type of option.
  • Multi-select swatch is a palette of colors or images that allows for selecting several option values at the same time. It’s possible to specify a min/max selection limit for that option.
  • Multi-select buttons are graphic/text boxes (see Button) that allow for selecting several option values at a time. It’s possible to specify a min/max selection limit for that option.
  • Text box shows up as a section on a page that allows a user to enter a text. This input type is used for one-line text only.

  • Multi-line text box is a section on a page that allows a user to enter multi-line text.

  • Number field is a section that allows a client to enter numbers only.

  • Date picker adds a calendar interface to a product page and allows a client to select a particular day. You can limit the date range, allow only certain days of the week or specific dates, and block holidays and other days off.

  • File upload is an input type that allows a client to upload images, text, or audio files.

  • Multiple file upload is an input type that allows customers to upload multiple files within a single option. Merchants can define minimum and maximum file limits (up to 30 files), restrict allowed file types, and choose whether pricing is applied per uploaded file or once for all uploaded files. This option type is available on the Growth plan.

Content options allow you to display additional information directly inside your option sets. Unlike regular option types, they are not used for collecting customer input and do not affect pricing, formulas, validation, cart properties, or product configuration.

They are designed to help stores improve the shopping experience by adding product information, instructions, images, buying guides, FAQs, and other helpful content directly alongside product options.

Starter and Growth plans:

  • Heading — display section titles and headings.

  • Paragraph — display formatted text and instructions.

  • Image — display images inside the option set.

  • Divider — add visual separators between sections.

  • Spacer — add vertical spacing between content blocks.

    Growth plan only:

  • Modal — display additional content inside a popup window. Useful for size charts, buying guides, FAQs, and detailed product information.

  • HTML-block — display custom HTML content directly inside the option set. Useful for advanced layouts, embedded content, videos, and custom storefront experiences.