bundle-builder
Bundle Builder
Configuration Guide
IN THIS GUIDE
App Overview
How to Create a Campaign
Adding the Widget to Your Product Page
Why Choose Bundle Builder
SEO Benefits
Tracking Performance
FAQ

What is Bundle Builder?

A complete bundle-selling solution built natively on Shopify.

Bundle Builder lets you create product bundle campaigns that appear as a sleek widget directly on your product pages. Customers can select complementary products, choose variants, and add the entire bundle to cart in one click — with your configured discount applied automatically at checkout via a Shopify Functions-powered discount.

Everything is managed from a single admin dashboard: create campaigns, pick products per tier, set discount rules, schedule start/end dates, add a countdown timer to create urgency, choose a widget layout, and track performance metrics — all without touching a line of code.


How to Create a Campaign

Set up your first bundle in under 5 minutes.

1
Open the Campaign Builder

From the Bundle Builder admin, click Create Campaign in the top navigation or on the Campaigns page. This opens the full campaign builder.

2
Fill in Campaign Details

Enter a Campaign Title (internal name for your reference), a Discount Title (shown in Shopify Discounts), and an optional Bundle Title and description displayed to customers inside the widget.

3
Set the Campaign Schedule

Choose a Start Date & Time and End Date & Time. The discount will only be active within this window. Outside these dates the widget hides itself automatically.

4
Configure Bundle Tiers

Each campaign supports multiple tiers. A tier is a group of products sold together at a specific discount. For each tier:

  • Give the tier a name (e.g. "Starter Pack")
  • Click Add Products to open the Shopify product picker
  • Choose a Discount Type: Percentage (%) or Fixed Price
  • Enter the Discount Value (e.g. 20 for 20% off)

5
Optional: Add a Countdown Timer

Toggle Show Countdown Timer to display a live countdown inside the widget. Set a separate countdown end date/time to create purchase urgency — great for flash sales and limited offers.

6
Choose a Widget Layout

Pick between Horizontal and Vertical widget layouts to match your theme's product page design.

7
Save or Publish

Click Save as Draft to save without activating, or Publish Campaign to make it live immediately. The Shopify automatic discount is created in the background.

Tip: You can edit any campaign at any time. Bundle Builder will delete and recreate the Shopify discount automatically so your rules stay in sync.

Adding the Widget to Your Product Page

A one-time theme customisation — no code required.

1
Open Theme Customizer

In your Shopify Admin go to Online Store → Themes, click Customize on your active theme.

2
Navigate to a Product Page Template

In the customizer, use the page-type dropdown at the top to switch to a Product page template (e.g. Default product).

3
Add the Bundle Builder Block

In the left sidebar scroll to the product section. Click Add block (or Add section depending on your theme). Search for Bundle Builder Bundle Widget and click to add it.

4
Position the Block

Drag the block to the desired position — typically just below the product title or below the Add-to-Cart button for maximum visibility.

5
Customise Block Settings

In the block settings panel you can change the Button Color and Text Color to match your brand. These are passed directly into the widget via CSS variables.

6
Save and Preview

Click Save in the customizer. Visit any product page that has an active campaign — the bundle widget will appear automatically. On pages without a matching campaign the block stays hidden.

How it works: The widget fetches campaign data from the /apps/Bundle Builder API using the current page's product ID. If a matching active campaign exists it renders automatically — no extra setup per product.
Note: You only need to add the Bundle Builder block once to your product template. It will show the correct campaign for each product automatically.
What customers see in the widget
  • Bundle title and optional description
  • Each tier listed with its products, variant selectors, original prices, and discounted prices
  • Crossed-out original price with green discounted price highlighted
  • Live countdown timer (if enabled)
  • Add Bundle to Cart button — adds all selected products/variants to the Shopify cart in one click
  • Automatic sold-out handling disables out-of-stock variants

Why Choose Bundle Builder

Built for merchants who want results without complexity.

🚀
Boosts Average Order Value

Bundle deals encourage customers to add more products in a single purchase — proven to increase AOV by 20–35% on average.

Zero-Code Setup

Add the widget to your theme in under 2 minutes using Shopify's native theme customizer. No developer needed.

🎯
Multi-Tier Discounts

Create different bundle groups in a single campaign — each tier can have its own products and its own discount rule.

⏱️
Countdown Timer

Create urgency with a live countdown timer displayed inside the widget — ideal for flash sales and limited-time offers.

🔧
Shopify Native Discounts

Discounts are applied using Shopify Functions — they appear in the cart and at checkout exactly like any other Shopify discount, with no workarounds or hacks.

📊
Built-in Analytics

Track widget views, add-to-cart events, and conversion rates per campaign — all from one dashboard without needing third-party tools.

🎨
Two Layout Options

Choose Horizontal or Vertical widget layouts to fit any theme design. Button and text colours are fully customisable.

🔄
Automatic Variant Sync

Variant selectors in the widget stay in sync with Shopify inventory. Out-of-stock variants are disabled automatically — no overselling.

📅
Campaign Scheduling

Set precise start and end dates for every campaign. Great for seasonal promotions, holidays, and limited-time events.

🛡️
Secure & Fast

Widget data is served from your own Shopify app endpoint. No third-party scripts, no performance drag, no privacy concerns.


SEO Benefits

Bundle Builder is designed to help, not hurt, your search rankings.

🖥️
Server-Side Rendered Block

The theme block is a Shopify Liquid file — it renders as plain HTML in the page source. Search engines index it with zero JavaScript dependency.

🐢
No Core Web Vitals Impact

The widget container is hidden (display:none) until data loads. There is no layout shift (CLS) during page load, protecting your Google Search ranking signals.

📦
Product Associations

Bundled products are displayed on the same page, giving search engines additional product context and helping with keyword co-occurrence.

Lazy-Loaded API Call

Campaign data is fetched asynchronously after DOMContentLoaded — it does not block page rendering or the browser's First Contentful Paint (FCP).

🔗
Longer Dwell Time

Bundle offers keep customers engaged on the product page longer, reducing bounce rate — a positive signal for SEO.

📈
Higher Conversion = Lower Bounce

Customers who interact with the widget are more likely to convert, which improves your site's engagement metrics tracked by search engines.

Best practice: Write meaningful Bundle Title and description text in your campaigns. This content is rendered into the page DOM and can be picked up by crawlers as product-related copy.

Tracking Performance

Understand which bundles are driving revenue.

Bundle Builder automatically tracks the following events for every campaign:

MetricWhat it measuresWhere to see it
Widget ViewsEvery time the bundle widget is displayed on a product pageCampaigns list + Dashboard
Add-to-CartEvery time the Add Bundle to Cart button is clickedCampaigns list + Dashboard
Conversion RateAdd-to-Cart ÷ Widget Views × 100Campaigns list + Dashboard
Active CampaignsCount of campaigns with status = activeDashboard overview
Tip: A good bundle widget conversion rate is 5–15%. If yours is below 3%, try a stronger discount or a more prominent widget position on the page.

Frequently Asked Questions

Answers to common setup questions.

Q: Can I have multiple campaigns for the same product?

A: Each product page shows one active campaign at a time — the most relevant active campaign found in the database. To avoid conflicts, make sure campaign schedules don't overlap for the same product.

Q: Does the discount apply automatically at checkout?

A: Yes. Bundle Builder uses a Shopify Functions-based automatic discount. When a customer adds a bundle to cart, the discount is applied automatically at checkout — no coupon code needed.

Q: Will the widget appear on every product page?

A: Only on product pages that have a matching active campaign. Pages without a campaign will show nothing — the block is invisible to customers.

Q: Can I customise the widget colours?

A: Yes. In the Shopify Theme Customizer, select the Bundle Builder Bundle Widget block and update the Button Color and Text Color settings to match your brand.

Q: What happens when a campaign expires?

A: When the end date/time passes, Shopify automatically deactivates the discount. The widget will stop fetching data for that campaign and remain hidden.

Q: Is the widget mobile-friendly?

A: Yes. Both the Horizontal and Vertical layouts are fully responsive and work on all screen sizes including mobile and tablet.

Q: Does Bundle Builder work with all Shopify themes?

A: Bundle Builder uses a Shopify App Block (theme extension), which is supported by all Online Store 2.0 themes. If you use a legacy theme, contact support.

Q: Does the app slow down my store?

A: No. The widget makes a single asynchronous API call after the page loads. It does not add any blocking scripts and has no impact on your store's First Contentful Paint or Core Web Vitals.


Ready to start bundling?

Create your first campaign in under 5 minutes and start boosting your average order value today.