The Related Bundles feature allows you to suggest bundles to customers on normal product pages.
For example, you could suggest the 'Mix and Match Cookie 6 Pack Bundle' on the individual 'Chocolate Cookie' product page.
Shoppers can go to the bundle page, or build and add the bundle in a quick add dialog without leaving the page. See Open bundles in a quick add dialog below.
Think of it as similar to the Related products feature that comes with most Shopify themes and the Search and Discovery app, but instead for your Biscuits Bundles specifically.
Watch the tutorial on YouTube:
After creating at least one bundle inside the app, you can then start assigning that bundle to show on the individual component product pages.
You select a bundle to manage related bundles for.
We load that bundle’s components (products/variants) and let you choose which component product pages show a link or suggestion to the bundle you've selected.
You can add, remove, and reorder the related bundles for:
Individual variants, or
All variants of a product at once (when their related lists are identical).
In your theme editor, add the “Related Bundles” app block to the product template(s) where you want related bundles to appear.
The 'Related Bundles' app block is different to the standard Biscuits Bundle Builder app block.
If the app block is missing or misconfigured, the app may show a banner with a quick link to fix it.
Open the Related Bundles page in the app.
Choose one of your bundles from the dropdown.
All of the components for that appear inside the bundle will load for you to manage them.
Select the variants you want to update (use the checkboxes, or the thumbnails).
Use the actions:
Add current bundle: Adds the chosen bundle as a related item to the selected variants.
Remove current bundle: Removes it from the selected variants.
Open a product row to adjust at the variant level:
Drag to reorder related bundles.
Click to remove an item from a single variant.
Use the product’s summary row when all child variants have the same list:
Reorder once to update all of its variants together.
Click Save when the Save bar appears.
You can then view the individual component products product page to see the bundle appear as a suggestion.
The Related Bundles block can open the bundle builder in a quick add dialog. Shoppers make their choices and add the bundle to the cart without leaving the product page.
In the theme editor, open your product template and select the Related Bundles app block.
Make sure that Card template includes btn, for example H. img | title | price | btn | badge (the default). The button settings show only for these templates.
Under Button, set Button action and styling to one of these options:
Open quick add - custom: uses the button colours that you set in this block.
Open quick add - inherited: uses your theme's button styles. To add more theme button styles, use Additional Button classes.
If you want, change Button text, for example to "Quick add". The default text is "View bundle".
Click Save. Then test the button on your storefront.
[screenshot - Related Bundles app block, Button section with Button action and styling set to Open quick add - custom]
[screenshot - product page with a related bundle open in the quick add dialog]
To send shoppers to the bundle page again, choose Go to product - custom or Go to product - inherited.
You do not need the app embed. The Related Bundles block loads the quick add dialog itself.
Modal or drawer: if the Biscuits Bundles app embed is on, the dialog uses its Biscuits quick add dialog style setting. If the app embed is off, the dialog opens as a modal.
After add to cart: on supported themes, the dialog closes and your theme's cart opens. On other themes, the dialog closes after 2 seconds and the bundle is in the cart. See the App embed: themes guide.
Custom JS does not run in the dialog. Custom JS from the Biscuits Bundle Builder app block does not run in the dialog. Custom CSS does.
For more about the dialog, see App embed: quick add and quick view settings.
Test on a copy of your theme before you publish.
Max shown: the Total items to display setting in the app block sets how many related bundles show (default 5, maximum 10). You can save more, but shoppers see only that number.
Per-variant control: Each variant can have its own related list. The list will change when the variant is changed on the product page.
Per-product summary: When all variants under a product match, you’ll see one unified list you can reorder/remove in one go.
Tabs and filters: Use tabs to focus on variants by step (or see All steps).
Nothing appears on product pages
Ensure the “Related Bundles” app block is added to that product’s template in the theme editor.
Check that at least one related bundle is configured for the product’s variant.
I saved more than 10 related bundles
Only 10 are shown on the storefront; reorder to prioritize what’s visible.
I changed theme or templates
Re-add the app block to the new/different product template if needed.
Changes not reflected
Verify you clicked Save in the app.
Refresh the product page and check that you’re viewing the correct template.
The button still goes to the bundle page
Make sure that Button action and styling is set to Open quick add - custom or Open quick add - inherited, and that you saved the theme.
Make sure that the bundle product still has the biscuits-bundle tag. The app adds this tag when it creates a bundle. Only products with this tag open the dialog.
The dialog shows an error instead of the bundle
Make sure that the Biscuits Bundle Builder app block is on the bundle's product template. See Why can't I see my bundles on the product page?.
You can also make a bundle appear on a different product's page. In the Theme Editor, open the target product, find the Biscuits Bundle Builder app block, and select a different bundle product to display. This works only for bundle products created in the app.
