Help
Troubleshooting
Most problems come down to theme setup or a bundle's product settings in Shopify. Find your problem below, and if it isn't listed, contact BundleM8 support.
The bundle form doesn't appear
Work through these in order:
- The app embed is off. In the theme editor, open App embeds and turn on BundleM8 Scripts. The form can't load without it.
- The product uses the wrong template. Open the bundle product in Shopify and check Theme template is set to the template with the Bundle Selection block, usually
bundles. - The block isn't on the template. Open the template in the theme editor and check the Bundle Selection block is there and isn't hidden.
- The bundle has no products. Open the bundle in BundleM8 and check it has at least one group with products, then save.
- The block is inside the theme's product form. With Enable Custom Form Handling on, the block must sit outside your theme's own product form. Move it out of the buy buttons area or into its own section.
- The bundle was just saved. Changes reach your storefront a few moments after saving. Refresh the page.
The product page shows two prices or two add to cart buttons
Your theme's own price and buy buttons are still showing alongside the bundle form. Hide them on the bundles template. See Hide your theme's buy buttons.
Add to cart does nothing
- A group's rules aren't met. Check for a message under one of the groups, such as "You must select more options from this group." Turn on Show selection hints to show the rules up front.
- Nothing is selected. The form shows "You must select a product." when the bundle would be empty.
- Custom form handling is off and the theme's form can't be found. With Enable Custom Form Handling off, the block needs your theme's product form on the same page. Turn custom form handling back on, or check your template includes the theme's buy buttons.
The bundle is sold out
- The product isn't active or published. Check the bundle product's status is Active and it's available on the Online Store sales channel.
- A fixed product is out of stock. Every bundle includes its fixed products, so if one is out of stock the bundle is too. Restock it, allow overselling for it, or make it optional.
- Every option in a required group is out of stock. If a group needs at least one selection and none of its products can be sold, no valid bundle can be made.
The cart doesn't show what's in the bundle
Your theme may not list the products inside bundles. Turn on Use cart attributes on the Bundle Selection block to add them to the cart item as visible properties.
If the bundle appears in the cart as a single product at the wrong price, with nothing inside it, another app may be changing the cart. Temporarily turn off other bundle, upsell or cart apps to find the conflict, then contact BundleM8 support.
Prices are wrong
- A product's price didn't update. Check Auto sync prices is on for the bundle, and the product doesn't have a custom price. See Auto sync prices.
- The product page price doesn't match the bundle form. Your theme shows the bundle product's price range, from the cheapest to the most expensive combination. The form shows the price of the customer's selection. See Price on your product page.
- You changed the bundle product's price in Shopify and it changed back. BundleM8 manages the bundle product's variant prices. Change prices in the bundle editor instead.
- A product is free unexpectedly. A fixed-amount bundle-wide discount larger than the product's price makes it free. Use a smaller amount or a percentage.
Check the Activity log to see when a price changed and where the change came from.
I can't save a bundle
The bundle editor highlights the problem:
| Message | Fix |
|---|---|
| Group title is required. | Give every group a title |
| Group must contain at least one product. | Add products to the group, or delete it |
| Group must contain at least one condition branch. | Add a branch to the condition group, or delete it |
| This bundle exceeds your plan's variant limit. | Remove products from the bundle, or upgrade your plan |
| This bundle's groups allow too many possible product combinations to compute. | Reduce the number of optional products, or narrow a group's minimum and maximum selections |
I can't create more bundles
You've reached your plan's bundle limit. Draft bundles count towards the limit, so delete bundles you no longer need, or upgrade. See Plans and billing.
A bundle went back to Draft on its own
- It's over your plan's variant limit. After a downgrade, bundles that use more linked variants than your plan allows are set to Draft and can't be made active. Remove products from the bundle, or upgrade.
- It was recovered after reinstalling BundleM8. Recovered bundles are recreated as drafts. See Reinstalling.
The grid layout doesn't show images
- The products don't have images, and no image metafield is set.
- The Image metafield setting doesn't match your metafield's namespace and key exactly. Check them under Settings → Custom data → Products.
- The bundle has more than 600 linked variants. Very large bundles don't show images.
My store isn't eligible for bundles
The dashboard shows this when your store doesn't meet Shopify's requirements. See Shopify bundle compatibility.