> ## Documentation Index
> Fetch the complete documentation index at: https://bundles-docs.getappfox.com/product-bundles/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Widget design and templates

> Pick a built-in style template, set one design for all your bundle widgets, override it per bundle, and save, export, or import design templates.

The **Design** tab sets how every Appfox bundle widget looks: layout, spacing, font, colours, badges, and the sticky add-to-cart bar. Set it once and every bundle follows it. If one bundle needs to look different, you can change just that bundle without touching the rest.

Use this page when you want your widgets to match your theme, or when you want to reuse a look across bundles or stores.

## Pick a style template

Every bundle type comes with ready-made looks. You pick one, and you can still change any setting afterwards.

| Bundle type | Templates |
| - | - |
| Quantity breaks | Classic, Bold cards, Compact list, Minimal outline, Pill selector |
| Complete the bundle and Classic bundle | Classic, Bundle card, Checklist, Image strip, Grid cards, Bundle chooser |
| Frequently bought together | Classic, Checklist, Image strip, Grid cards |
| Mix & match | Classic, Compact list, Sections, Curated set, Box builder (with a progress bar) |
| Buy X, get Y | Classic, Gift highlight, Buy / Get split |

**When you create a bundle**: pick a type. The editor opens with that type's default look. Open **Style** and click **Change style** to pick another.

**For an existing bundle**: open the bundle, open **Style**, and click **Change style**. Choose a look and click **Apply**. If you had changed the bundle's layout, colours, corner radius, font or badges, a window lists those settings first, because the style replaces them. Your text, products and offers never change.

**Match my theme**: select **Match my theme** in the gallery to use your theme's font and button style instead of the template's colours.

Your saved templates appear in the same gallery under **My templates**.

Bundles you created before style templates existed use **Classic** and look exactly as before.

## Set your global design

**1. Open the Design tab**

Go to **Settings** → **Design**. The left side has your settings. The right side shows a live preview.

![Design tab with global design settings on the left and a live widget preview on the right](https://mintcdn.com/appfox-bundles/IQXBRzu9-ipLK1j2/product-bundles/docs/images/54-settings-design.png?fit=max\&auto=format\&n=IQXBRzu9-ipLK1j2\&q=85\&s=50fac9989702be1d08b89ab784468678)

To start from one of the built-in looks, click **Change style** next to the **Global design** heading and pick a style. It copies the template's layout, shape and badge style into your global design. Click **Save** to keep it.

**2. Pick a brand colour**

Choose one of the preset colours or enter your own under **Brand colour**. Buttons and selected offers use it.

**3. Adjust layout and typography**

Open **Layout and typography**:

* **Layout**: Vertical (default), Horizontal, Grid, or Plain (no borders). For Grid, also choose **Items per row** (2, 3, or 4).
* **Corner radius** and **Spacing**: how rounded the cards are and how much space sits between them.
* **Font family**: keep **Inherit theme font** to match your store, or pick your theme's body or heading font, System sans-serif, Serif, Monospace, or Rounded.

![Layout and typography section with Layout set to Grid and the Items per row option](https://mintcdn.com/appfox-bundles/IQXBRzu9-ipLK1j2/product-bundles/docs/images/55-design-layout-grid.png?fit=max\&auto=format\&n=IQXBRzu9-ipLK1j2\&q=85\&s=ba694ce29e0e4259205ca87ba9ad8ef8)

### Style your bundle title

Open **Bundle title** to change the heading above your offers. Choose a **Bundle title color** with the color picker, a font, a size from 12–64 px, a weight, left/center/right alignment, normal or italic style, and letter case. These settings leave product names and offer labels unchanged.

You see changes in the live preview as you edit. Theme fonts use your storefront’s theme font variables; the admin preview uses its available fallback fonts. Save to apply your changes. Use **Reset bundle title** to restore widget defaults, or **Use global bundle title** in a bundle editor to inherit your global title settings again.

**4. Fine-tune colours**

Open **Colours and gradients** to set colours for cards, text, buttons, and the selected offer. Buttons and selected offers can use a gradient: set **From**, **To**, and **Angle**.

![Colours and gradients section with From, To and Angle fields for a button gradient](https://mintcdn.com/appfox-bundles/IQXBRzu9-ipLK1j2/product-bundles/docs/images/56-design-gradient.png?fit=max\&auto=format\&n=IQXBRzu9-ipLK1j2\&q=85\&s=28711f17b16379d084a3479927f16314)

**5. Style your badges**

Open **Badges** and choose a **Badge style** (Ribbon, Sticker, Pill / corner tag, or Tag on the top edge) and a **Badge size**. Badges are labels like "Most popular" or "Save 20%". **Tag on the top edge** sits inside the top of the offer card, so a theme can't cut it off, and a long label wraps onto more lines instead of covering the price.

**6. Choose where savings show (optional)**

Quantity-break tiers can show a subtitle under the tier title, such as "Standard price" or "You save 15%". Write it in each offer's subtitle field. You can use `{{saved_total}}` and `{{saved_percent}}`, and an empty subtitle shows nothing.

Open **Savings** and choose a **Savings position**: **Under the price** (the default for existing bundles) or **Next to the tier title**, which shows the savings as a pill beside the title. **Savings style** switches between a brand-coloured pill and a neutral grey chip. You can change the colours under **Colours and gradients**.

**7. Make the selected tier easier to spot (optional)**

Open **Tier cards** to change how quantity-break tiers look. **Radio style** is **Browser default** (the default for existing bundles) or **Filled**, which draws the radio in your accent colour and gives the selected tier a 2px outline. Select **Dim tiers that are not selected** to fade the other tiers until a shopper hovers over them or tabs to them. The **Quantity breaks** templates and the **Bold cards** and **Minimal outline** styles start with the filled radio.

**8. Choose where add-ons show (optional)**

Open **Add-ons** and choose an **Add-on placement**: **Below the offers** (the default for existing bundles) or **Inside the selected tier**. Inside the selected tier, checkbox add-ons and personalisation fields sit in the card of the tier your shopper picks, with a thumbnail, the price and the crossed-out original price. Their choices stay when the shopper switches tier. Widgets without tier cards, such as fixed bundles, keep add-ons below the offers. The **Bundle + add-on** template starts with this placement.

**9. Turn on the sticky add-to-cart bar (optional)**

Open **Sticky add-to-cart** and select **Show a sticky bar when the widget scrolls out of view**. Then choose:

* **Position**: bottom or top of the screen.
* **Button text**.
* **If the theme already has a sticky bar**: **Don't show ours**, or **Hide the theme's and show ours**.

![Sticky add-to-cart section with the sticky bar turned on and its position, button text and theme options](https://mintcdn.com/appfox-bundles/IQXBRzu9-ipLK1j2/product-bundles/docs/images/57-design-sticky-atc.png?fit=max\&auto=format\&n=IQXBRzu9-ipLK1j2\&q=85\&s=2d033b347a96914f7c984209ceef3f53)

**10. Check the preview, then save**

Use **Widget** above the preview to switch between Quantity breaks, Complete the bundle, Classic bundle, Buy X, get Y, Mix & match, and Frequently bought together. Switch between **Desktop** and **Mobile**. When it looks right, click **Save** in the save bar.

![Widget preview switched to Mobile, with the Widget dropdown for choosing a bundle type](https://mintcdn.com/appfox-bundles/IQXBRzu9-ipLK1j2/product-bundles/docs/images/58-design-preview-mobile.png?fit=max\&auto=format\&n=IQXBRzu9-ipLK1j2\&q=85\&s=a4ee4fd1ca61776edc627fe820e23f35)

## Show bundles as one chooser

Open **Bundle chooser** and select **Show bundles for this product as one chooser**. On a product page, your shoppers then see one list: the product on its own, then each Fixed or Classic set that includes that product. One button adds the choice they pick. The product on its own is added at its normal price, with no bundle discount.

Volume discounts, mix and match, and bundles with add-ons, personalisation, variant choices, or subscriptions stay as their own widgets. Leave the setting off and every bundle keeps its own widget, which is how existing shops look.

The **Bundle chooser** style and the **Product + accessory sets** template show this list in the preview. The list appears on your storefront only when this setting is on.

## Give one bundle its own look

Every bundle uses the global design until you change something in that bundle.

1. Go to **Bundles** and open the bundle.
2. Open **Style**. A banner shows **Using the global design**.
3. Change any setting. The banner changes to **This bundle overrides the global design** and lists what's different.
4. Click **Save**.

To undo it, click **Reset to global** in the same banner.

![Bundle editor Design card with the banner This bundle overrides the global design and a Reset to global button](https://mintcdn.com/appfox-bundles/IQXBRzu9-ipLK1j2/product-bundles/docs/images/59-bundle-design-override.png?fit=max\&auto=format\&n=IQXBRzu9-ipLK1j2\&q=85\&s=04a8a02fdce5d19bc0de1096d03cfab8)

## Apply the global design to all bundles

If you've changed bundles one by one and want them all to match again:

1. Save any changes on the Design tab first.
2. Click **Apply to all bundles…**.
3. Choose what every bundle should take from the global design: Layout, Corner radius and spacing, Font, Colours and gradients, Badges, or Sticky bar.
4. The window lists the bundles that will change. Click **Apply to** *N* **bundles**.

Only the parts you selected change. Bundles that never overrode those settings stay as they are.

![Apply the global design to all bundles window with Layout, Corner radius and spacing, and Colours selected, listing the 6 bundles that will change](https://mintcdn.com/appfox-bundles/IQXBRzu9-ipLK1j2/product-bundles/docs/images/60-design-apply-all.png?fit=max\&auto=format\&n=IQXBRzu9-ipLK1j2\&q=85\&s=51deb13b4de46464b7a4d98c97e7528f)

## Save and reuse templates

A template is a saved design you can switch back to, or move to another store.

* **Save**: click **Save as template** next to the **Global design** heading and give it a name.
* **Use**: under **Saved templates**, click **Use as global design**. This replaces your current global design, so save it as a template first if you want to keep it.
* **Export**: click **Export** to download the template as a JSON file.
* **Import**: paste an exported JSON into **Import a template (paste the exported JSON)** and click **Import template**.
* **Delete**: click **Delete**. Bundles that already use the design keep their look.

To apply a saved template to just a few bundles, select them in the bundles list and use **Apply style**. See [Manage bundles](https://bundles-docs.getappfox.com/product-bundles/docs/dashboard/manage-bundles.md).

## Good to know

* Widget text (button labels, titles) isn't set here. Change it in **Settings** → **Translations**. See [Supported languages](https://bundles-docs.getappfox.com/product-bundles/docs/settings/supported-languages.md).
* The cart banner and cart rewards bar use your global colours, spacing, corner radius, and font.
* For anything the Design tab can't do, use [Custom CSS](https://bundles-docs.getappfox.com/product-bundles/docs/settings/custom-css.md).
* Your theme's own CSS can sometimes win over these settings. If the storefront doesn't match the preview, see [Troubleshooting](https://bundles-docs.getappfox.com/product-bundles/docs/help/troubleshooting.md).

> [!TIP]
>
> Need help? Contact us at [support@getappfox.com](mailto:support@getappfox.com).

## Compact density

Under **Layout and typography**, set **Density** to **Compact** to reduce spacing on narrow screens. Only your selected quantity tier shows its full details, and long option lists scroll inside their panel. Long names still wrap so your shoppers can read them.

Choose it in Global design for all bundles, or override **Density** in an individual bundle’s Design panel. **Standard** keeps the existing spacing. Use the mobile preview to check your design at 390px.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.