Bundles Pro documentation / Help

Troubleshooting

Fixes for common Bundles Pro problems. A bundle that won't save or is stuck building, more variants than you picked, prices that didn't change, components you can't edit in Shopify, storefront blocks or the Included in bundles card not showing a bundle, missing sales and API errors.

Last updated November 5, 20265 min read

Find the problem below. If it isn't listed, or the fix doesn't work, email support@ftwelvelabs.com with your store's address and the bundle's name.

Saving a bundle

"The bundle couldn't be saved"

The red banner shows Shopify's own reason under the heading. The usual causes:

The store can't sell bundles. Stores with checkout.liquid customizations can't use product bundles (Eligibility and considerations for product bundles). Bundles Pro doesn't check this before you save, so the first save is where you find out.
Too many options. A bundle can have up to three options across all its products (Add a product fixed bundle). Three products with both a Size and a Color option make six. Pick a single variant of some products, or leave one out.
A product is itself a bundle. "Bundles can't contain other bundles" (same Shopify page).
A product uses purchase options, such as a subscription or pre-order. Bundles can't be sold with them.

"This bundle would have N variants (max 250)"

Each combination of the variants you pick is one variant of the bundle. Pick fewer variants with Choose variants. Bundle variants and pricing shows how to count them.

"Shopify is building your bundle" doesn't go away

Creating a bundle, or changing its products, is done by Shopify in the background and usually takes a few seconds. If the banner stays for more than a minute:

Go back to Bundles. A Bundles in progress banner lists bundles Shopify is still building.
Wait a few seconds and refresh. Bundles Pro finishes the bundle (status, sales channels, prices) when it sees Shopify is done.

If a bundle never appears, Shopify may have refused it. Open Create bundle again with the same products to see Shopify's reason in the red banner.

The bundle has more variants than I picked

Bundles choose option values, not single variants: picking Red / S and Blue / M gives four combinations. The Check the variant selection banner after saving says which product expanded. See Why two picks can become four.

A new size of a product isn't in the bundle

If the product was on All variants, open the bundle in Bundles Pro and click Save. New variants are added on the next save. If you'd chosen specific variants, use Choose variants to add the new one.

Prices

The bundle price didn't change when a product's price did

Bundle prices are set when you save the bundle. Open it in Bundles Pro and click Save. See When a product's price changes.

My price change in Shopify was undone

Saving in Bundles Pro resets every variant's price to the bundle's pricing mode. Set the price in Bundles Pro instead: Fixed price for one price, or a percentage off.

Editing in Shopify

I can't change the bundle's products in Shopify

That's Shopify's rule: "After an app has assigned components to a bundle, only that app can manage the components of the bundle." (Add a product fixed bundle) Use the edit link on the Bundled products card, which opens the bundle in Bundles Pro. The title, images, description and SEO are edited in Shopify as usual.

A product's SKU changed

Shopify says: "If a component's SKU changes, then you need to delete and recreate the entire bundle." (Eligibility and considerations) Create a new bundle in Bundles Pro with the same products and pricing, then delete the old one in Products.

Storefront and admin cards

"Buy the bundle instead" or "Included in bundles" doesn't list a bundle

Both list only bundles that are Active and published to the Online Store. Drafts and bundles only on POS or other channels aren't listed. Open the bundle, click Publish, tick Online Store, and tick Set status to Active if it's a draft.

Hide sold-out bundles in Buy the bundle instead also leaves out bundles that are sold out.

"Buy the bundle instead" says Choose options, not Add bundle

Add bundle adds the bundle straight to the cart, so it only shows when the bundle has a single variant. A bundle with variants needs the shopper to pick them on the bundle's page. See Storefront blocks.

A block doesn't show on the storefront

On Bundles, check Store setup. Not added means the block isn't on your live theme. Click Add to product page.
On 1 of 3 product templates means some products use a template without the block. Add it to the others in the theme editor.
What's in this bundle only shows on bundles; Buy the bundle instead only on products that are in a live bundle.

Store setup says "Can't check"

Bundles Pro couldn't read your theme. If there's a banner asking you to accept updated permissions, do that and refresh.

Analytics

A sale is missing

Click Import last 60 days on Analytics. Only bundles in Bundles Pro count, and only orders from the last 60 days can be imported. See Bundle analytics.

Revenue doesn't match Shopify's reports

Bundle revenue doesn't take off order-wide discounts or refunds, and uses UTC days. See What counts as revenue.

API (Pro)

Error code	Fix
`unauthorized`	The token is wrong or revoked. Create a new key on API access
`plan_required`	The store is on Free. See Plans and limits
`insufficient_scope`	The key is Read only. Create a Read and write key
`rate_limited`	More than 120 requests a minute on this key. Wait for the number of seconds in `Retry-After`
`invalid_bundle`	Shopify refused the bundle. The message has Shopify's reason (see Saving a bundle)
`too_many_variants`	Over 250 bundle variants. Send fewer `variantIds`

The full list is in Create and update bundles with the API.

A bundle created through the API is unpublished until you send publicationIds, so it won't show on the storefront or in the blocks. Its status and prices are applied when you poll the operation until it's COMPLETE, or when someone opens Bundles in the app within a day.