Complementary products

Product page section

Theme retirement Ira is no longer available on the Shopify theme store. Theme support and updates for current users will end after May 18, 2024. Learn more here.

Update | This feature was added in v4.9.0 on Jan 6, 2022. See our change log and Theme update guide to learn more.

In the Product template, the Complementary products section shows customers related products that they can purchase in addition to the current product. Create a custom product list that pair well together.

This guide shows you how to set up the Complementary products block. For similar features, see guides for Recommended products section.

Set up section

Follow the steps to add a complementary products section with a custom product list. You can customize the heading and layout of the block.


In your theme editor (Customize):

  1. In the Product template, click (+) Add section and select Complementary Products.

  2. Click the new Complementary products section to open the settings.

  3. Select the Posts per row using the slider: 2, 3, or 4. Select the number of Rows: 1, 2, or 3.

  4. (Optional). Select an Image aspect ratio to change the shape of the product images. Either Square, Landscape, or Portrait.

    The default Natural setting will display the original orientation of your image.

  5. Under Products to show, choose to use a Custom product list or Search & Discovery app recommendations.

  6. Click Select products to manually choose what products to display.

    To show different products on different product pages, follow the instructions below to add a Product metafield to use as a dynamic source.

  7. Click Save.

Add dynamic content for different products

If you want to show different complementary products on specific product pages, you can use Shopify's metafields and dynamic sources. These features allow you to store custom information for each of your products and automatically display that information on the correct product pages.

Watch the video or follow the steps below to create metafields for your products, add complementary products to those metafields, then use Dynamic sources to connect those metafields to the complementary products block.

For a general introduction, see our Dynamic sources and metafields tutorial.

1. Create product list metafield

Create a Product metafield to add multiple complementary products to each product page in your Shopify Admin.

Shopify's Metafields lets you store additional information about your products. You can create custom fields to hold different types of information in your Shopify admin, and enter unique content for each of your products.

The steps below tell you how to add a metafield for storing text that you want to display in the collapsible rows block.


In your theme editor (Customize):

  1. Click the Complementary products block to open the settings.

  2. Next to Custom product list, click the Insert dynamic source button and select (+) Add Metafield.

    Alternatively, go to Settings > Custom data in your Shopify admin.

  3. Click the Products tab.

  4. Click the Add definition button in the top-right.

  5. Enter a Name that describes what information the metafield will contain. For example: "Related products".

  6. Click (+) Select type button and select List of products.

  7. Click Save.

2. Add products to metafield

Once you've created a product list Metafield, you can now add multiple products to those fields by going to your products in the Shopify admin.


In your Shopify Admin:

  1. In the Shopify admin:

  2. Go to your Product inventory in your Shopify admin and open one of your Products.

  3. Scroll down to the Metafields section and find your product list metafield, then click on the field to Select products.

  4. Click Save.

  5. Repeat steps 1 - 3 to populate the product list metafield for each of your products.

3. Insert metafields as dynamic sources

You can go to the theme editor to insert a Dynamic source in the Complementary products section.


In your theme editor (Customize):

  1. Click on a Complementary products section to open the settings.

  2. Click the Insert dynamic source button next to Customer product list

  3. Select the Metafield that you created.

  4. You can now preview your store to confirm the correct product list appears when viewing different products.

  5. Click Save.

Related links

Product template Recommended products

Last updated