Combined listings: when separate products act as one

Combined Listings vs. ordinary variants: what changes

A Shopify Combined Listing is a storefront listing that connects separate products under shared options. The parent product is the main listing; its child products are the individual products grouped within it. Shoppers see the shared options as variants, while each child product can retain details such as its own title, description, URL, or image gallery.

That structure is useful when related offerings need to be selectable together but should not be flattened into a single product’s variant structure. Think through what the shopper is choosing: if an option represents a separate product with its own product-level content, a Combined Listing may suit the merchandising model better than treating every choice as an ordinary variant.

Keep the two levels of options distinct when planning the product data. Listing-level options belong to the parent listing and are added separately from any existing variant options on the child products. Option names must be unique across the parent and its children. Child-product variants remain separate and can be edited from the child product or variant details page.

Check plan, channel, theme, and listing limits first

Check store eligibility and storefront readiness before organizing products for a Combined Listing. The Combined Listings app is available on Plus and enterprise commerce plans, and displaying a listing requires the Online Store sales channel and a compatible theme.

Free Shopify themes support Combined Listings from version 15.0.0; other themes might need code customization to display them. Treat theme compatibility as an implementation check, not an assumption: identify the theme and version, then confirm the listing actually renders in the storefront before making the setup public.

Check the product group against the documented limits before you start. A listing can contain up to 60 products and up to 3 listing-level options, in addition to each child product’s options; by default, it can have up to 2,048 variants across its child products. Products must already exist, and a product can belong to only one Combined Listing at a time.

Use those constraints to decide whether to split or simplify a product group before building it. Pay particular attention to option names: a name already used by a child product’s variants cannot also be used as a listing-level option name. Resolving that conflict during planning is easier than reworking the product structure later.

Create the listing in the Combined Listings app

Create and check the child products before connecting them in the Combined Listings app. Only existing products can be added, so complete the product details and any child-product variants you need first. This also gives you a chance to settle the shared option names and values before those choices appear together in the listing.

The documented setup flow is to open Apps > Combined Listings in Shopify admin, choose Create combined listing, enter a title, and add the existing products. Then define the listing-level options and values, check that their names are unique across the parent and children, and save.

You can enter option values manually or populate them by connecting a category metafield. Choose the method that fits the data you already maintain: if you use a relevant category metafield, check its values against the products you intend to group; if entering values manually, compare spelling and formatting across the group before saving.

A new Combined Listing is Draft by default. Treat that as a useful checkpoint: review the product group, options, and storefront presentation before changing the status. Draft status does not remove the need to test the actual theme experience.

• Confirm each child product exists and is not already part of another Combined Listing.
• Add the products, define unique listing-level option names and values, and save.
• Record any theme or product-page app behavior that still needs checking before publication.

Choose a status and understand what shoppers see

After creation, set the parent listing’s status according to how you want shoppers to find it. Set it to Active to publish it, or choose Unlisted to keep it accessible by URL while hiding it from collections, search, and product recommendations.

On a Combined Listing product page, listing options appear at the top of the product details. The child product’s variants remain separate from those listing options, so inspect both levels as you review the page: confirm the shared choice is clear and that any child-product choices still make sense for the selected product.

Do not assume that making a child product Unlisted removes its option value from the Combined Listing. A child product’s option value can still appear in the listing when that child product is Unlisted. Decide whether that visible choice fits the shopping journey, and check the result in the storefront rather than relying only on the product status.

Product images, theme behavior, and preview checks

A child product can retain its own image gallery, but do not assume that a theme will present a particular group of images automatically when a shopper selects a listing option. If showing a specific image group for a selected option is a requirement, Shopify suggests considering the Combined Listings app for that use case.

Make the image behavior an explicit design decision before launch. Note which images belong with each child product, select each listing option in the storefront, and compare what the shopper sees with the intended product presentation. If the result depends on theme customization, verify that behavior in the theme rather than promising it based on the product setup alone.

Also preview the Combined Listing product page for compatibility with apps that add information to product pages. Shopify notes that those apps might not be compatible with Combined Listing product pages, so check important product-page content in the preview and investigate missing or misplaced information before publishing.

Storefront test checklist before launch

Test the Combined Listing as a shopper would use it, then check the underlying product structure if something looks wrong. A saved listing can have correct product data and still need attention in the theme or on the product page, so validate both the selectable options and the surrounding presentation.

Work through the checks below in order, recording anything that needs a theme adjustment or a product-data change. Keep the preview and the live storefront behavior aligned with the status you plan to use.

If the listing is intended to be Active, confirm it is published as intended; if it is Unlisted, check access by URL and confirm it is hidden from the specified discovery surfaces. Recheck the child-product option values, especially if any child is Unlisted.

• Confirm the Online Store channel and compatible theme are in place, and verify the listing renders on the product page.
• Select each listing option and check that the displayed choice is understandable and that child-product variants remain distinct.
• Review each child product’s title, description, URL, and image gallery in the context of the selection.
• Preview the page with installed product-page apps and check for missing or misplaced information.
• Check the intended publication status and how Unlisted child products appear in the listing.