The bundle block should look like part of your product page, not like an app bolted onto it. Three tabs under Customize in the bundle editor control that: Settings for layout and behaviour, Colors for every colour, and Text for fonts and sizes. Two settings on the Settings tab also change what your theme displays, and those are the ones worth understanding before you switch them on.
In this article:
Layout and spacing
On the Settings tab, the first card holds Bundle title, Bundle title alignment (Left, Center or Right) and Offer layout, which switches the whole bundle between Vertical and Horizontal.
The spacing controls below it depend on the layout:
Layout | Controls |
|
|
|
|
Pricing display, including the two theme settings
Under Pricing display options on the Settings tab:
Setting | What it does |
| Horizontal layout only. Shows each offer's price on its card. |
| Vertical layout only. Shows each offer's average price per unit instead of its total. |
| Shows a crossed-out price when it differs from the offer's price. With the Horizontal layout, only while |
| Bases the crossed-out price on the product's compare-at price in Shopify, times the quantity, instead of its regular price |
|
|
| Changes the price your theme displays |
| Changes the savings badge your theme displays. Only works while |
On a new bundle, Show compare-at price, Use product compare-at price and both theme settings are on, the other two are off, and Price rounding is None.
Below them, under Cart & checkout behaviour, Skip cart (redirect to checkout) sends customers straight to checkout when they add a bundle, so your cart and the Atlas cart drawer, with its upsells, are skipped. It is off by default.
⚠️ The last two reach outside the bundle block. Update theme product price rewrites the price shown by your theme's own product section to match the selected offer. It makes the page consistent, and it also means your product page price changes as customers click between offers. If that is unexpected, this is the setting responsible. See Why does my product image change when a bundle is active?
Show individual unit price is worth turning on for quantity breaks. "3 for $54" means less than "3 for $54, that's $18 each" when the single unit price is $24.
If a crossed-out price or total is not what you expect, see Why is my bundle's crossed-out price or total not what I expect?.
Variant images and swatches
Under Variant image settings on the Settings tab, which only shows with the Vertical layout. A Horizontal bundle keeps whatever these were set to.
Setting | What it does |
| Size and corner rounding of variant images |
| Shows an image per variant in the bundle. On by default. |
| Changes the main product image when a customer picks a variant in the bundle. On by default. |
| Off by default. While it is off, Atlas draws its own swatches in the bundle and hides your theme's own variant picker on themes built like Shopify's Dawn. On, the bundle uses your theme's swatch styling and your theme's picker stays. |
Edit swatches and Set default variants sit under Products, next to the product selection. Edit swatches configures the swatches themselves, and Use AI can do that for you.
⚠️ Two of these are behind common surprises. Display variant's image as main product image when selected is why the main product photo changes when a customer picks a colour in the bundle. Use native theme swatches decides whether your theme's own variant picker stays on the page and whose swatches the bundle uses. Both are covered in the troubleshooting articles below.
If swatch options will not load you may see We couldn't load product options from Shopify. Please try again in a moment., or a more specific message asking you to select a collection or at least one product first. Some selected products could not be read. Remove and re-add them, then try again. means one product in your selection is the problem.
Setting default variants
Set default variants opens a window of the same name. Select an offer in the preview on the left, choose its starting variants on the right, then select Done and save the bundle to keep them.
For a
Bundle Productsoffer, each product gets its own card underSet the variant each product starts on. A product set to a single variant, or one that only has one variant, has nothing to choose and is left out. If every product in the offer is like that, the window showsEvery product in this offer uses a fixed variant.For other offers, use
Select productto choose which product you are setting variants for.If the offer has upsells, each one is listed under
Upsell default variants.
Each choice keeps the product on a variant that exists, so a default is always a real variant of that product. In the editor preview and on your store, each product starts on its default. A product with no default starts on its first variant. Swapping a product with Change product clears its default.
Colours
The Colors tab groups every colour control:
Group | Covers |
| Line accent, title, subtitle, background, selected background, hover background, bundle title, border, radio button, border radius, border thickness |
| Badge background, badge text, gradient start and end |
| Price and compare-at price |
| Inner badge background and text |
| Upsell background, selected background, text, selected text |
| Gift background, selected background, text, selected text |
| Selector background, text, border, and variant label colour |
| Timer background, text, and gradient |
Most groups support gradients. Gradient direction offers Left to right, Right to left, Top to bottom, Bottom to top, Top left to bottom right and Top right to bottom left.
On a Horizontal bundle there are extra gradient controls: Use gradient for background, Use gradient for selected background and Use gradient for border, each with its own start colour, end colour and direction, plus a separate Selected background for the offer the customer has chosen.
Offer gradients apply to a scope you choose with Add background gradient to: None, Main offer, Selected offer, or All offers. There is also a gradient font colour, labelled Font color (overrides offer text colors).
💡 Take your colours from your theme rather than inventing them. Copy the hex values your theme uses for buttons, borders and body text, and the block stops looking like a separate app.
Text and fonts
The Text tab groups typography by area: Main text, Badge & label text, Price text, and Upsell & gift text.
Each group offers Font size (px) and Font weight & style, with weights from Light (300) through Extra bold (800), each with an italic variant.
Font sizes are validated on save. A value outside a range stops the save, and the field shows its limit, such as Badge font size cannot exceed 16px:
Field | The editor accepts | Saved as |
Offer title | 12 to 32 | 12 to 30 |
Offer subtitle | 10 to 24 | 10 to 20 |
Badge | 8 to 16 | 8 to 16 |
Price | 12 to 28 | 12 to 24 |
Compare price | 10 to 24 | 12 to 20 |
Values are in pixels. A value outside the first range stops the save, and the field says why. A value inside it but outside the second is saved at the nearest limit: an offer title of 32 is saved as 30, and a compare price of 10 is saved as 12.
The Horizontal layout
Setting Offer layout to Horizontal shows your offers as cards side by side, and the bundle title becomes Select Quantity: until you change it. It also changes what you can set:
A bundle holds up to 4 offers, rather than 20 with the Vertical layout.
Each offer has a
Header badge(Text, with placeholdere.g. Most popular,Background colorandText color), anOffer label(Text, with placeholdere.g. Save 20%) andText colors(Title colorandSubtitle color), instead ofBadge details.Upsells and free gifts on offers, the
Progressive Giftstab and theAI wizardtab are not available.The card controls on the
Settingstab areSpacing between cards(16 px by default),Image size(45),Border radius(12) andBorder thickness(2).Prices show on the cards only while
Show price on cardis on.
A practical order to work in
Get the offers right first. Design decisions are easier once the content is settled.
Set the layout and spacing.
Set colours, starting from your theme's existing values.
Set fonts last, and only where the defaults genuinely clash.
Preview on mobile before publishing.
ℹ️ The editor preview shows unsaved changes, so you can experiment freely. Nothing reaches your store until you publish the bundle.



