For the complete documentation index, see llms.txt. This page is also available as Markdown.

Options overview

The Options page is where every product option gets its display style and its swatches.

Options is the main working page of the app. It lists every product option the app found in your catalog — Color, Size, Material, Style, and any custom option you use — and lets you decide, per option, how it should look on product pages and on collection pages.

The top of the Options page: four summary cards and the Sync your online store and support cards
The summary cards tell you at a glance how many options still need swatches.

What's on the page

Summary cards

Card
What it counts

Options detected

Product options found in your catalog.

Need setup

Options that still have values without a colour or image.

Products affected

Products that use those options.

Options shown on collection pages

Options with swatches enabled on collection pages.

Sync your online store

Update data refreshes the app's copy of your catalog. Run it whenever you add products or variants — see Sync product data.

Product page / Collection page

The two tabs switch which surface you're configuring. Each option is set up independently for product pages and for collection pages, so you can (for example) show full image swatches on the product page and small colour dots on collection pages.

The option cards

Each option shows:

  • the option name, Used by how many products, and the first couple of its values;

  • Status — Ready, or Needs setup when values are still missing a colour or image;

  • Set swatches — opens the value editor (only for styles that use colours or images);

  • Display on Desktop and Display on Mobile — the display style pickers;

  • Show custom badges — on the Product page tab only, see Custom badges.

When values are incomplete, a banner on the card reads n color values are missing. with Complete setup, which jumps straight to the value editor.

An option card with status Needs setup and a banner reading 16 color values are missing, with a Complete setup button
An option that still has values without a colour is flagged, with a shortcut straight to the editor.

Use the Search for item field to find an option quickly, and the arrows at the bottom to page through long lists.

Changes on this page are not live until you click Save in the bar at the top.

Where to go next

Last updated

Was this helpful?