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

Quickstart: your first combined listing

Create and publish your first combined listing in about five minutes.

This walkthrough creates the simplest kind of group — products that vary by one option, like Color — and publishes it to your storefront.

Before you start

  • Install the app and turn on the app embed.

  • Have at least two products that are variations of each other (e.g. Summer Tee — Red and Summer Tee — Blue).

Create the group

1

Start a new group

Go to Groups → Create group and choose Group by single option.

Create group page showing four group type cards to choose from
Choose Group by single option to start your first group.
2

The product picker opens first. Search, then select each variation. Products already in another group appear disabled — a product can only belong to one group.

Product picker with two products selected
Pick the products you want to link together.
3

Name the option and its values

Set the option name (e.g. Color) and one value per product (e.g. Red, Blue). Each value gets a swatch: First image, One color, Two colors, or Custom image.

Group editor showing the option card and a product row for each linked product
Each product gets its own value — the swatch preview updates live.
4

Check the live preview

The right-hand preview shows exactly how the widget will look, with Product page and Product card tabs. The default style works out of the box — if you'd like a different look, pick one of the ready-made styles (see Styles).

5

Publish

Click Publish group. The group is created with status Active and syncs to your storefront.

Storefront updates are processed in the background and cached by Shopify's CDN — allow a minute or two for changes to appear.

6

Preview on your storefront

Open one of the linked products on your store. The option widget appears on the product page and on collection cards.

Storefront product page with the new swatch widget
Your new group live on the storefront, ready for customers.

Next steps

Last updated

Was this helpful?