How to setup Popular Upgrades (Product Bundle) in product pages

This method applies the same bundle products to all product pages.

• Click the Select button under the Products field

  

• A product selection menu will appear. Select multiple related products that you want to offer as part of the bundle

  

• The products chosen this way will apply globally to all products across the store.

💡 Note: This method is useful if you want a fixed set of upsell products for all product pages, but it does not allow dynamic product bundling per individual product.

To overcome the limitation of using the same products across the store, you can use metafields to link a unique list of products for each product page.

• Instead of manually selecting products, you can use a metafield to dynamically display bundle products for each product individually.

• Click the database icon next to the Select button to open the metafield selection menu.

  

• Choose the desired product metafield from the list.
• If you do not have a metafield set up, you will need to create one first. Please follow the instruction right below:

Setting up the metafield for bundle products

1. Go to Shopify Admin > Settings > Custom Data > Product.

   

2. Click Add definition.

3. Set the Name for the metafield (e.g., "Popular upgrades" or "Bundle Products").

   

4. Setting a Namespace and Key is required, but the value does not need to follow a specific format. A common value is custom.popular_upgrades.
5. Under Type, select Product.
6. Change the product type to List of Products.

7. Save the metafield definition.

8. Go to your products in admin and navigate to the Metafields section. You should see the Popular upgrades field. Click on it then click Select products to select the products you want.

   

9. This will automatically pull bundle products from the assigned metafield in your Shopify product data. Each product can have a unique bundle of products, allowing greater customization compared to the global method.

   

This is the most advanced method, enabling variant-specific bundle products that change dynamically when a customer switches variants. You can specify the list of product variants via the Metafield setting field.

💡 Note: If the Metafield field is set in the Product bundle block, that means this method is chosen, and this will take priority over all other methods.

Why use this method?

• Unlike the first 2 methods, this method enables variant-specific bundle products.

• If the main product has multiple variants (e.g., a speaker with different colors like Black, Green, and Chestnut), the Popular Upgrades section will change accordingly when the user switches variants.

  

• For example, switching the color from Black to Green will update accessories (e.g., cover) to their corresponding Green variants.

How to set up variant-level metafields

To properly configure variant-specific bundle products, you need to create a variant-level metafield in your Shopify admin. Follow these steps:

1. Create a variant-specific metafield:

   • Go to Shopify Admin > Settings > Custom Data > Variants.

     

   • Click Add definition.

   • Set the Name (e.g., "Product bundle").

     

   • Set a Namespace and Key (this can be any value, but you must enter the exact value in the settings of the Product Bundle block). For example, as shown in the screenshot, you can use custom.product_bundle as the Namespace and Key.
   • Under Type, select Product variant.

   • Choose List of Product Variants (not a single product variant).

     💡 Note: Alternatively, you can use Product with List of products (just like the metafield type in the second method), which is also supported. In this case, the Product bundle block will display products with their first variant name included. For example, if the first variant of the Cover is Red, it will be listed as Cover (Red)

   • Save the metafield definition.

2. Assign the metafield to variants:

   • Go to Shopify Admin > Products.
   • Select a product that has multiple variants.
   • Open each variant and scroll down to the Metafields section and click on Product bundle field.

   • Click Select variants to choose appropriate variants. For example, in the product called Soundroll on our demo, let's try to set the bundle for variant Green.

     

     Here we choose the Green cover for the speaker:

     

   • You can select multiple variants here. For example, you can choose an audio cable and a charging cable for the speaker, just like our demo.
   • Do the same for other variants and save the product.

3. Connect the Metafield in the Bundle Product Block:

   • Go back to the Bundle product block.

   • In the Metafield field, enter the exact namespace and key you created (e.g., custom.product_bundle).

     

   • Save the changes.

Now, when a customer selects a different variant, the Popular Upgrades section will dynamically update to match the selected variant’s associated bundle products.