SoloraContact
All Solora apps
Documentation

Getting the most out of Combined Listings

A combined listing is a set of separate products that shoppers browse as one, linked by a group and shown as swatches. Nothing in your catalogue is edited — products, prices and inventory stay exactly as they are. Everything below follows from that.

Start here

How it works

A combined listing is a set of separate products — say a Red tee, a Blue tee and a Black tee — that shoppers browse as one. Combined Listings links them with a group: each member product gets a swatch, and every product page, collection card and search result in the group shows the whole row. Other pages, including the home page, show no swatches, so a featured collection on the home page has none. Clicking a swatch opens that colour’s own product page.

Your products stay separate products with their own inventory, reviews and URLs; the app adds only a small metafield to each member so your storefront can draw the row.

A Classic Tee - Red product page with Red, Blue, Black and Sand swatches. The shopper clicks Blue and the Classic Tee - Blue page opens, then clicks Black.
On a product page, each swatch opens that colour's own product. The ringed swatch is the one you are on.
A New in collection of a tee, a hoodie, a tote and a cap, each card with its own row of colour swatches. The shopper clicks Navy under the hoodie and the Everyday Hoodie - Navy page opens.
Collection and search cards get their own row, so shoppers can jump to a colour straight from the grid.

Nothing in your catalogue is edited

Combined Listings never changes titles, variants, images, prices or inventory, and never edits theme files.

Setup

Turn it on in your theme

  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. The block only shows while the app embed is on.

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

The setup guide step Turn on the app embed, whose Open theme editor button opens the theme editor on App embeds. The cursor switches on Combined Listings, clicks Save, and a row of colour swatches appears on the product page in the preview.
In App embeds, switch on Combined Listings and save. Once you save your first group, its swatch row shows up on those product pages.
The setup guide step Place the swatch block, whose Open theme editor button opens the theme editor on the product template. The cursor drags the Combined Listings block into place and the swatch row moves to that spot in the preview.
Optional: drag the Combined Listings app block to exactly where the swatch row should sit.

Swatch row in the wrong place?

In the app, open Design and enter a CSS selector in Product page selector under Placement (advanced). The row is placed right after the first element that matches, unless the app block is on the page, in which case the block decides and the selector is ignored.

Groups

Create your first group

  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

    In the Products step, 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. If that fails, the group shows Sync failed and is retried within about an hour.

The Groups page in the Combined Listings admin. The cursor clicks Create group, types Classic Tee, adds the red, blue and other Classic Tee products, enters a colour hex for each swatch and clicks Save.
Create group: title it, add the products, give each its swatch colour and save.

A product can be in one group at a time

Adding a product that already belongs to another group is blocked, so a storefront never shows two rows for one product.

Groups

Group a catalogue by rule

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. All three rule types keep working after you save them: a new or edited product that matches joins its group on its own. A rule never creates a new group by itself, and a change to a metafield alone may need Run rule now.

Groups

Import and export

Import / export moves groups in and out as a CSV file. Export CSV gives 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 groups were imported and can download an error report for the rest.

Gallery

Variant images

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.

An All-Mountain Snowboard product page with a four-photo gallery. Picking the Midnight design swaps the gallery to the four Midnight photos, then picking Ember swaps it to the Ember photos.
Pick a design and the gallery keeps only that variant's photos: Aurora, then Midnight, then Ember.

Theme support

Gallery filtering works on Dawn and themes built like it, wherever Combined Listings recognises the gallery. On a gallery it does not recognise, the theme keeps drawing it as before.

Design

Swatch appearance

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.

A product page whose colour swatches restyle in place: circle, square and rounded shapes, a larger size, then the sold-out Sand swatch struck through, hidden and dimmed. A label beside Color names each setting.
Circle, Square and Rounded, then a sold-out colour shown with Strike through and with Dim. Each step is labelled on the image.
The Design page in the Combined Listings admin. The cursor changes the swatch shape to Rounded, drags the size slider, sets the out-of-stock style to Strike through, and the live preview updates before the cursor clicks Save.
Design in the app: shape, size and out-of-stock style, with a live preview before you save.

Collections

One card per variant

Card per variant shows one collection card per value of an option — one card per colour, for example — instead of one card per product. It applies to collection pages only; search results are not split. Choose the Option to explode and the Max cards per product.

This changes how the collection page behaves

The theme’s product count and its “Showing 1–24 of N” text no longer match the number of cards, and a collection sorted by price is no longer strictly in price order. It is off until you switch it on.

Themes

Supported themes

Combined Listings finds the variant picker, gallery and product cards on its own; cards loaded later (filter, sort, load more) get swatches only on card layouts it recognises. 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 Product page selector (see Setup) or add the app block, or email us with your theme’s name.

Billing

Plans

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

Full details live on the pricing page.

Changing plans never deletes anything

A plan’s limit caps how many groups are live. Move to a plan with a lower limit and your most recently edited groups stay live up to it (10 on Free); the rest are paused and their swatches are hidden. Upgrading doesn’t switch paused groups back on: resume the ones you want from Product groups, up to your new limit. Paused groups stay editable.

Data

Removing the app

Uninstalling turns the storefront code off straight away. The swatch data the app wrote stays on your products as ordinary metafields, and a small amount of app data stays on your shop, because an uninstalled app can no longer reach your store. Your products, images and variants are not touched.

Troubleshooting

Common questions

I created a group but see no swatches.

Check that the Combined Listings app embed is switched on in your live theme (the setup checklist on Home shows this unless you have hidden it), then reload the product page.

The row appears but in an odd spot.

Add the app block to your product template and drag it where you want it. If the block is on the page, the Product page selector under Design → Placement (advanced) is ignored; without the block, set that selector instead.

Stock doesn't show on swatches.

Stock and prices come from your store’s Storefront API. They appear once the app has created its storefront token, which happens the first time you save your Appearance or Card per variant settings.

Swatches disappeared after I filtered or sorted a collection.

Swatches are redrawn automatically when a theme reloads the product grid, but only on card layouts Combined Listings recognises. If they still disappear, reload the page and email us with your theme’s name so we can add support.

How do I get help?

Email [email protected].

Still stuck? Talk to a human.

Combined Listings is built by a small team at Solora Commerce. Send us your store domain and what you expected to happen, and we will look at the actual group.