Log in
Start free trial

Combined listings

Use the Combined Listings app to combine products into an enhanced product listing on your online storefront.

A combined listing is a product type created by connecting separate products from your store into a single product listing. Combined listings are connected by a shared option, such as color, model, or dimension. The products in a combined listing display as variants on your online storefront, but can contain additional product details not usually available at the variant level, such as a title, description, unique URL, or image gallery.

A combined listing has both a parent product (the main combined listing) and child products (the individual products included in the listing). When viewing a combined listing in your Shopify admin or online store, the combined listing options are displayed at the top of the product details page.

On this page

Eligibility requirements

To be eligible for the Shopify Combined Listings app, your store must meet the following requirements:

  • You must be on either a Plus or enterprise commerce plan.
  • Your store must be using the Online Store sales channel.
  • To display combined listings on your storefront, you must have a compatible theme.

Theme eligibility requirements

Combined listings display on free Shopify themes in version 15.0.0 or later.

For all other themes, your theme code might require additional customization to display combined listings on your storefront. You can find instructions for updating your theme code in the developer documentation for supporting high-variant products. If you need help with making changes to your theme, then contact your theme's developer for support.

If you're not sure whether your theme is compatible, then you can contact your theme's developer for support.

Incompatibility considerations

Certain features and apps are either incompatible with the Combined Listings app, or prevent certain options within the Combined Listings app from working as expected. Review the following considerations:

  • Combined listings only display on your online storefront.
  • A combined listing can't be added as a featured product on your online store.
  • Child products might display as a product recommendation for different child products that share a combined listing.
  • Apps that display information on product pages in your online store might not be compatible with combined listing product pages. You can preview the combined listing product page before publishing it to test app compatibility.
  • Combined listings can't be added to a product bundle or added as a subscription product.
  • When filtering product options with the Shopify Search & Discovery app, the child products of a combined listing won't be included in the filter results.

Review additional considerations for creating combined listings.

Identifying combined listings

Combined listings are displayed in the Products section of your Shopify admin as a unique product listing separate from its child products.

You can identify combined listing products in the following areas of your Shopify admin:

  • In the Products section, the Inventory column displays Combined listings with XX variants for a combined listing.
  • A combined listing and its child products display the Combined Listings app block on the product details page.
  • The Variants section of a combined listing parent and its child products product details page have the following differences from a regular product:
    • The Variants section of the product details page displays the options and option values added from the Combined Listings app. You can click Edit with Combined Listings to edit the combined listing options in the Combined Listings app.
    • The child product's variants are displayed separately, and can be edited from the product details page or variant details page.

Creating a combined listing

To create a combined listing, group your products by a shared option, such as size or color. For example, you sell shoes on your online store in different colors and sizes. You can add Size as an option to each product that you want to add to the combined listing, and then can add a Color option to the combined listing:

Considerations for creating a combined listing

Certain features are either incompatible with the Combined Listings app, or prevent certain options within the Combined Listings app. Review the following considerations before creating a combined listing.

Considerations for combined listing options

Review the following considerations for combined listing options:

  • All option names in a combined listing parent and child must be unique. For example, if the products that you want to add to the listing already have an option named Color, then don't add an option named Color to the combined listing.
  • Combined listing parent options are added separately from, and in addition to, any existing variant options in the child products.
  • An option value can't be empty.
  • Each option value must be unique.
  • You can manually enter values for each option, or connect category metafields to populate your combined listing option values. Learn more about using category metafields in the Combined Listings app.

Considerations for adding child products to a combined listing

Review the following considerations for adding child products to a combined listing:

  • Products can be included only in one combined listing at a time. If a product is already in a combined listing, then it can't be added to another combined listing. You can create a new product, or remove the product from the existing combined listing, and then add it to another combined listing.
  • Only an existing product can be added to a combined listing. You must add or update your products before you can add them to a combined listing.
  • A combined listing can't be added as a child product of another combined listing.
  • If you duplicate a combined listing product, then it's created as a regular product.

Combined listing maximum values

Combined listings have the following maximum values:

  • A combined listing can have a combined maximum of 2,000 variant option values across all child products.
  • You can add up to 60 products to a combined listing.
  • You can add up to 3 options to a combined listing, in addition to the options in each product included in the listing.

Category metafields in the Combined Listings app

If you've added a category to your child product details, then you can connect that category metafield in the Combined Listings app to populate options and option values for your combined listing.

Review the following considerations when connecting metafield categories to your combined listing:

  • Category metafields can be connected only if at least one child product has a category assigned.
  • If a child product has more than one entry in a category metafield, then only the first value will connect to the combined listing option value automatically.
  • Changing a category metafield in your combined listing doesn't update the category metafield in your child product.

Learn more about category metafields and Shopify's Standard Product Taxonomy.

Create a combined listing

By default, your combined listing product is set to Draft status. After you create your combined listing, you can adjust the product status from the product details page in the Products section of your Shopify admin.

Steps:

  1. From your Shopify admin, go to Apps > Combined Listings.
  2. Click Create combined listing.
  3. Enter a title for your combined listing.
  4. Click Add products.
  5. In the modal, select products by clicking the checkbox next to the product listing. You can also use the search bar to find specific products.
  6. Click Add products.
  7. Add a unique option in the Option name.
  8. Optional: Click Add another option to add up to 3 options.
  9. In the Products section, enter a value for the option to each product in one of the following ways:
  • Manually enter an option value.
  • Click the option name field, and then select the relevant category metafield to populate the option values with existing metaobjects. After option values populate, you can select metaobjects for empty option values, and edit the populated option values to ensure the correct metaobject is connected.
  1. Click Save to create the combined listing.
  2. Optional: Click change the status to add any additional product details, and then set the product status to Active to publish the combined listing.

Delete a combined listing

A combined listing can't be recovered after deletion. Deleting a combined listing removes it from the Combined Listings app, from your storefront, and from the Products section of your Shopify admin.

Child products that were included in a deleted combined listing aren't deleted.

Steps:

  1. From your Shopify admin, go to Apps > Combined Listings.
  2. Click the combined listing that you want to delete.
  3. Click Delete combined listing.
  4. Click Delete to confirm.

You can also delete or archive a combined listing from the Products section of your Shopify admin.

Edit combined listings

You can add, edit, or remove products from a combined listing, as well as add, edit, remove, or reorder options for existing combined listings from the Shopify Combined Listings app.

To edit the product details of a combined listing, such as product media or the product description, go to the product details page in the Products section of your Shopify admin. You can also click View product page from the Combined Listings app's index page.

You can edit the product details of a combined listings child product, including product variant options, from the product details page in the Products section of your Shopify admin:

Add a child product

  1. From your Shopify admin, go to Apps > Combined Listings.

  2. Click the combined listing that you want to edit.

  3. Click + Add Products.

  4. Select or deselect products by clicking the checkbox next to the product listing. You can use the search bar to filter specific products.

  5. Click Select to update the included products.

  6. In the Products section, enter a value for each option.

  7. Click Save to add the new product.

Remove a child product

  1. From your Shopify admin, go to Apps > Combined Listings.

  2. Click the combined listing that you want to edit.

  3. Click X next to any product that you want to remove from the combined listing.

  4. Click Save to remove the product.

Add an option

  1. From your Shopify admin, go to Apps > Combined Listings.

  2. Click the combined listing that you want to edit.

  3. In the options section, click + Add another option.

  4. Enter a unique name for the option or connect a category metafield.

  5. Enter option values for the new option in each child product.

  6. Click Save to add the new option.

Edit or remove an option

  1. From your Shopify admin, go to Apps > Combined Listings.

  2. Click the combined listing that you want to edit.

  3. In the options section, make any of the following changes to the option:

    • Edit the option name.
    • Click the trash icon to delete the option.

  4. Click Save.

Edit an option value

  1. From your Shopify admin, go to Apps > Combined Listings.

  2. Click the combined listing that you want to edit.

  3. Edit the option value of any child products that you want to change.

  4. Click Save to update the option value.

Reorder options and option values

You can reorder combined listing options from the Combined Listings app. To reorder the child products options, you can change the display order of variant options from the product details page in the Products section of your Shopify admin.

  1. From your Shopify admin, go to Apps > Combined Listings.

  2. Click the combined listing that you want to edit.

  3. Click ⇆ Reorder.

  4. In the Reorder options modal, do any of the following:

    • To rearrange the option order, use the drag and drop handles ⠿ next to the option.
    • To rearrange the option value order, use the drag and drop handles ⠿ next to the option value.

  5. Click Confirm to update the option order.

  6. Click Save to save the new option order.

You can use the Shopify Search and Discovery app to change how combined listings products display in search results and product recommendations on your online store.

By default, only child products are displayed. However, you can update the app settings to display parent products only, or both parent and child products.

Steps:

  1. In the Shopify Search & Discovery app, click Settings.
  2. In the Products section, select one of the following options for how combined listings display in search results, auto-generated product recommendations, or both:
  • To display only the child products of combined listings, click Only show child products.
  • To display only the parent products of combined listings, click Only show parent products.
  • To display both the parent and child products of combined listings, click Show both.
  1. Click Save.

Learn more about customizing storefront search with the Search & Discovery app.

Can’t find the answers you’re looking for? We’re here to help.