How to add Bundles
How to add Bundles
ConvertX bundles allow you to increase AOV by offering quantity-based or multi-offer deals directly on your product pages.
This guide explains how to:
Customize a bundle
Publish it
Ensure it displays correctly on your store
Bundle customization overview
When creating or editing a bundle, the customization screen is split into two main areas:
Left panel
Bundle configuration with two tabs:
General
Style
Right panel
A live preview of the bundle on a selected product
Everything you change is reflected instantly in the preview.
General tab
The General tab controls how the bundle behaves and where it is displayed.
Name & targeting
Internal bundle name
Used only inside ConvertX. Must be unique.
Targeted products
All products
Specific products
Specific collections
If a bundle with the same internal name already exists, publishing will fail.
Visibility options
Control what information is displayed inside the bundle:
Main text (headline)
Compare-at price
Price per item
Hide the theme’s variant picker
Hide the theme’s quantity selector
These options help you keep the product page clean and conversion-focused.
Selector type & settings
Choose how variants are selected inside the bundle:
Dropdown selector
Color or image-based selector
You can configure:
Selector style
Variant images or colors (via Shopify metafields)
Variant images and colors are managed using Shopify product metafields.
Bundle offers
Bundles are made of offers.
Each offer includes:
Quantity
Discount type and value
Offer title
Offer description
Optional label and badge
Optional image or gift
You can:
Set one offer as default
Add multiple offers
Highlight a popular offer
Style tab
The Style tab controls the visual appearance of your bundle.
You can customize:
Text sizes and weights
Colors
Separators
Labels and badges
Borders and background
Selected state styles
Use the Style tab to match your bundle perfectly with your theme.
Preview your bundle
On the right side, you can select a product to preview the bundle.
This preview shows:
Real product prices
Variant selectors
Discounts
Selected offer state
Always preview your bundle before publishing to avoid layout issues.
Publish the bundle
Once your bundle is ready, click Publish bundle.
What happens when you publish
The bundle is automatically added to the product pages you targeted
The bundle appears using a ConvertX App Block
No manual placement is required in most cases
Add the bundle manually (if needed)
If the bundle does not appear or you want to change its position:
Click "Add manually"
From the publish confirmation screen, click Add manually.
Open the Theme Editor
You are redirected to the Shopify theme editor.
Add the ConvertX App Block
On the product page:
Add the ConvertX App Block
Select the bundle
Place it correctly
Move the bundle above the Add to Cart button.
Save your changes
Click Save to apply.
For best results, always place bundles above the Add to Cart button.
Publish button not working
If the Publish bundle button does not work, check the following:
Each bundle must have a unique internal name.
Some bundle features and quantities depend on your plan.
Upgrade your plan or remove unused bundles.
Make sure at least one valid offer is configured.
Best practices
Use 2 to 3 offers max
Highlight one offer as default
Keep the main text short and benefit-driven
Always preview before publishing