Skip to main content

Customizing how your bundle looks

Colours, text, fonts and layout for the bundle block, including the two settings that change what your theme displays.

Written by Eddie Lavandera

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

Vertical

Offer image size & radius (Size and Radius), Spacing between offers

Horizontal

Spacing between cards, Image size, Border radius, Border thickness


Pricing display, including the two theme settings

Under Pricing display options on the Settings tab:

Setting

What it does

Show price on card

Horizontal layout only. Shows each offer's price on its card.

Show individual unit price

Vertical layout only. Shows each offer's average price per unit instead of its total.

Show compare-at price

Shows a crossed-out price when it differs from the offer's price. With the Horizontal layout, only while Show price on card is on.

Use product compare-at price

Bases the crossed-out price on the product's compare-at price in Shopify, times the quantity, instead of its regular price

Price rounding

None, Round to .99, Round to .95 or Round to .00. Rounds offer prices down to that ending, for example $59.98 to $58.99, and checkout charges the rounded price. Regular Price (no discount) offers are not rounded.

Update theme product price

Changes the price your theme displays

Update theme savings badge

Changes the savings badge your theme displays. Only works while Update theme product price is on.

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 Radius

Size and corner rounding of variant images

Show variant images

Shows an image per variant in the bundle. On by default.

Display variant's image as main product image when selected

Changes the main product image when a customer picks a variant in the bundle. On by default.

Use native theme swatches

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 Products offer, each product gets its own card under Set 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 shows Every product in this offer uses a fixed variant.

  • For other offers, use Select product to 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

General colors

Line accent, title, subtitle, background, selected background, hover background, bundle title, border, radio button, border radius, border thickness

Badge colors

Badge background, badge text, gradient start and end

Price colors

Price and compare-at price

Inner badge colors

Inner badge background and text

Upsell colors

Upsell background, selected background, text, selected text

Gift colors

Gift background, selected background, text, selected text

Variant selector colors

Selector background, text, border, and variant label colour

Countdown timer colors

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 placeholder e.g. Most popular, Background color and Text color), an Offer label (Text, with placeholder e.g. Save 20%) and Text colors (Title color and Subtitle color), instead of Badge details.

  • Upsells and free gifts on offers, the Progressive Gifts tab and the AI wizard tab are not available.

  • The card controls on the Settings tab are Spacing between cards (16 px by default), Image size (45), Border radius (12) and Border thickness (2).

  • Prices show on the cards only while Show price on card is on.


A practical order to work in

  1. Get the offers right first. Design decisions are easier once the content is settled.

  2. Set the layout and spacing.

  3. Set colours, starting from your theme's existing values.

  4. Set fonts last, and only where the defaults genuinely clash.

  5. 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.


Next steps

Did this answer your question?