Getting the most out of Combined Listings

1. 1

   In the app, open Home and follow the setup checklist.

2. 2

   On Turn on the app embed, click Open theme editor. In App embeds, switch on Combined Listings and save.

3. 3

   Optional: add the Combined Listings app block to your product template if you want to choose exactly where the row sits.

Turn on the app embed on every theme; on older (vintage) themes that cannot hold app blocks it is the only option.

1. 1

   Open Groups and click Create group.

2. 2

   Enter a Title. The Handle fills itself and Option name starts as Color.

3. 3

   Under Members, click Add products and pick the products that belong together.

4. 4

   For each member, enter its Option value (for example Red), choose a Swatch type — a colour, an image, or text — and set the swatch.

5. 5

   Click Save. The swatch data is written to each member product within seconds.

Auto-group builds groups from products that match a rule: a Title prefix (everything before a separator becomes the group), a Tag prefix such as color:, or a Metafield key such as custom.family. Click Preview rule to see the groups, conflicts and duplicates before anything is created. A saved rule keeps working: a product you add later joins its group on its own.

Import / export moves groups in and out as a CSV file. Export CSVgives every group’s handle, title, option and members, ready to edit and re-import. Imports run in the background; when one finishes you see how many rows were imported and can download an error report for the rest.

Variant images shows only the photos that belong to the selected variant. Choose a product, then pick photos per variant, or use Auto-match by alt text or Auto-match by filename. Variants with no image selected fall back to the theme’s normal gallery.

Appearance sets the Swatch shape (Circle, Square or Rounded), the size, the corner radius, and what happens to a swatch once every variant it represents is sold out: No change, Dim, Strike through, or Hide. The live preview shows your swatches on a sample product page, drawn by the storefront code.

Card per variant shows one collection and search card per value of an option — one card per colour, for example — instead of one card per product. Choose the Option to explode and the Max cards per product.

Combined Listings finds the variant picker, gallery and product cards on its own. It has a profile for Dawn, places the row under the variant picker on Horizon, and falls back to the add-to-cart form on other themes. If the row lands somewhere odd, use Custom mount selector(see Setup) or add the app block, or email us with your theme’s name.

Every feature is on every plan, including Free. Plans differ only in how many groups you can create: Free 10, Starter 200, Growth 1,000, Pro unlimited.

Full details live on the pricing page.

Uninstalling turns the storefront code off straight away. The swatch data the app wrote stays on your products as ordinary metafields in the solora_cl namespace, and your shop keeps its solora_cl.settings metafield, which holds the storefront token, because an uninstalled app can no longer reach your store. To leave nothing behind, first open Settings → Remove app data in the app, type REMOVE and confirm: it deletes every group, rule, variant-image mapping and appearance setting, plus the swatch data on your products and the shop metafield, and revokes the storefront token. Your products, images and variants are not touched.