FAQs from merchants using Bundle Builder.

Why is a new product created when I create a bundle?

This is how the Bundle Builder app works. When you create a bundle a 'ghost' product is created in your store's admin. This allows us to ensure the inventory is synced correctly when someone purchases the bundle.

Can I edit the bundle product page template?

No. Please do not edit the ‘ghost’ bundle product page information. Editing / changing any information here may affect the functionality of the app.

Why is a new variant added when someone purchases a bundle?

When a customer adds the bundle to their cart they will see a unique bundle number attached to their order. This is added as a variant in your store’s admin. We need the unique Bundle numbers stored in the admin along with the sale and bundle contents information to ensure all your products and variants inventory are synced correctly.

A customer purchases a variant by adding it to a cart, and that variant can be in their cart for a long time, and different customers will have different bundle configurations in their cart at the same time. So we can't use just one variant.

A new variant is not created for every bundle sold, just different bundle configurations created, so if two customers purchase exactly the same bundle configuration, it'll be just one variant in the store's admin.

Once the variants hit 100 in your store’s admin, the app will automatically create a new ‘ghost bundle product’.

Bundle Builder will continue to use the variants from the initial ghost bundle product and so you can’t make the ‘old’ products unavailable in your online store. They need to be kept available, or your bundles will get an ‘Out of Stock’ message at check out. The best way to avoid having the duplicate bundle products showing in your store, is to keep the bundles in the automatically created ‘Bundle Builder Products’ collection that is set to ‘unavailable’.

Why can't I change the setting from 'Single' to 'Multiple Section' after creating a bundle?

Once a bundle has been created, the product set-up setting, either ‘single’ or ‘multiple-section’ cannot be changed, however, you can create a new bundle.

Can I change the wording on the buttons/labels on the bundle page?

Yes. Please go to Settings in the top right-hand corner of the app, and then click on Translation. Here you can change the wording for most of the buttons and labels used on the bundle page.
You can also translate them here into any language you like.

Can I change the name ‘Bundle #'?

Yes. You can change the prefix/wording of 'Bundle #' in the Product Options at the bottom of the page when you create the bundle.

Where can I see the SKU for each product in the bundle?

You can enable the SKU for each product to show on the cart page. Click on the ‘Settings’ button in the top right-hand corner of the Bundle Builder app and click on ‘General’. Then enable the checkbox for Show SKU, and Save.

Individual product SKUs should also show up by default in the 'Orders' section of your Shopify admin when someone places an order for a bundle.

Can I create a unique SKU for the bundle product?

Yes. You can set this in the Product Options, at the bottom of the bundle admin page.

Can I create a unique Vendor for the bundle product?

Yes. You can set this in the Product Options, at the bottom of the bundle admin page.

How do you show the individual products that make up the bundle in the cart, instead of just the product bundle?

We use Shopify's line item properties to show customers their bundle contents in the cart and in email receipts and order confirmations, and some merchants use this to help fulfil orders. If you set the line item properties to show in your theme and email templates you can see the bundle contents listed out like this example screenshot (taken from our demo store selling fruit):

Bundle items are shown in the cart, but not as separate products

Shopify has a handy guide on how to integrate the line item properties here:

Then once integrated go to the Bundle Builder app and click on the ‘Settings’ button in the top right-hand corner and click ‘General’. Scroll down and enable the checkbox ‘Enable line item properties’, and Save.

We can not show the items as individual products in the cart because having the 'bundle product' is how we manage inventories and discounts, which wouldn't be possible if the items were separate. For example, if there was a minimum of 5 products per bundle, once added to the cart the customer would have the ability to remove one/all.

How do I add my own styles?

Click on the ‘Settings’ button in the top right-hand corner and then click on ‘Design’. We have included a ‘Custom CSS’ box for you to add your own CSS to override the Bundle Builder default styles.

What is the image specification for the bundle header image?

The bundle header image should be at least 1100px wide and no larger than 2MB.

What is the file size limit for the bundle product image and header image?

The file size limit is 2MB for the bundle product image and 2MB for the bundle header image. If the image you upload is larger than this, the bundle will not save.
Please note that the larger the file size the longer the bundle page may take to load. Please also ensure your images are optimised for web use.

How can I download all of my bundle orders information?

You can download a CSV export of your bundle data in the Settings area of the app. Go to Settings in the top right-hand corner and then click on Export.

If you require order data passed 60 days, you will need to give us permission to read all your order data. You will be prompted in Settings > Export to do this with the click of a button.

The export may take 5 to 10 minutes to complete.

Will Bundle Builder allow the customer to buy the bundle if some of the variants are out of stock, but set to sell even when out of stock in my store?

Bundle Builder only prevents a bundle from being purchased when some product added to the bundle is out of stock but is prohibited to sell when out of stock in your store.
Bundle Builder will just subtract the product from inventory and doesn't mind if the number goes negative in this case.

How do I get rid of the ‘Default Title’ text in the dropdown on my bundle page?

Please go to Settings in the top right-hand corner of the app, and click on General. Then uncheck the box for ‘Single Option Variant’, and Save the change. This will remove the ‘Default Title’ text.

I’m trying to install the app but it is redirecting me on a loop and won’t install?

Are you using the Ghostery extension? For some reason, this extension interferes with Shopify apps. Please disable the extension to install the app.

The discounted price on the bundle product on my collection page/bundle promo is not showing the correct price?

The price of a bundle in a collection will show the minimal achievable price for that bundle. So if there are 3 products in your bundle with prices $10, $15, and $20, the bundle product will show a price of $10, as this is the minimal achievable price of that bundle.

However, if you have set limits and/or have required products, then these step in to dynamically calculate the minimal achievable price. For example; if you set a limit of ‘total products = 3’ on this bundle, then the price shown for the bundle would then change to $30 (3x the lowest achievable price of $10).

There a couple of things that you can do if this pricing is not working for you. Firstly set a minimum price for the bundle, secondly, if that does not work for your configuration requirements, uncheck the box for ‘show discounted price’ in the bundle admin. And thirdly you could change the text with custom CSS to say ‘From X price’ indicating to the customer that this is the lowest achievable price and that the price may go up.

Is there a way to transfer the bundle contents information to our 3rd party fulfilment/warehouse company?

Bundle Builder provides a way for 3rd party systems such as fulfilment, warehouse, and inventory services and applications, to read information about the contents of the bundles purchased by your customers via the Shopify admin API.

The bundle contents information is stored in a metafield for a Variant that represents one specific configuration of a bundle.

Please note that multiple customers can share a bundle variant if they added exactly the same product variants when configuring their bundle.

The metafield is called bundle-contents and is in the bundle-builder namespace. The value is JSON encoded.
In order to read this information, you need to look at the individual variant of a bundle product.

Here is an example of what the metafield might look like with example products and variants:
"id": 399,
"Outfits xx",
"variants": [
"variant_id": 38742265160,
"product_id": 9955921800, "section_id": 403,
"section_name": "T-Shirts",
"variant_title": "Small",
"price": 12.95,
"sku": "DB47-BLK-0",
"product_title": "Silver Bulldog T-Shirt""
"variant_id": 38742324808,
"product_id": 9955927240,
"section_id": 403, "section_name": "T-Shirts",
"variant_title": "Black w/ Bow", "price": 4.95,
"sku": "DB192-BLK-0",
"product_title": "Black Velvet Bow T-Shirt (Various Styles)"
} ]}

Here are the definitions for the fields:

id - internal Id of given bundle configuration, guaranteed to be unique for all stores
bundle_name - name of the bundle
variants - array of individual variants that a customer added to the bundle:
variant_id - Id of a variant (same as in Shopify Admin API)
product_id - Id of a product (same as in Shopify Admin API)
section_id - Unique identification of a section (for multi-section bundles), might be null
section_name - Name of the section, might be null or blank
variant_title - Title of selected variant (Default Title) if there are no customer-facing variants
price - price of given variant in shop currency
sku - SKU of given variant, might be null or blank
product_title - Title of the product

Please note that all fields are only updated at the time the customer adds the exact bundle configuration to the cart and are not updated when products/variants change.

Only use variant_id and product_id for current data, other fields are provided for convenience.

Does the app install script in my theme automatically?

On install Bundle Builder automatically inserts one file into the theme: 'templates/product.bundlebuilder.liquid'. This redirects users from the product page to the bundle page.

Bundle Builder also automatically creates a collection in your store called "Bundle Builder Products". This is where all bundles are stored once created. Please note: This collection is not automatically removed when the app is uninstalled.

When I uninstall the app do I need to remove the file from my theme?

The 'templates/product.bundlebuilder.liquid' file is only used for bundle products, so not removing it shouldn't affect anything on your site. However if you want to remove it, just search ‘ Bundle Builder’ in your theme liquid and remove it.