# Charm builder

> Add the Add-on builder section so shoppers pick a bracelet or chain plus charms and add them to the bag together.

Source: https://spellnsell.com/themes/kera/docs/jewelry-tools/charm-builder · Kera 1.0.0 · Updated 2026-11-15

**Where:** Online Store > Themes > Customize > Add section > Shopping tools > Add-on builder

A base piece, such as a bracelet or chain, with charms the shopper adds or takes off with a + / − button. A running total shows the set, and one button adds everything to the bag, each charm as its own line. In the editor the section is called **Add-on builder** and each charm is an **Add-on** block, so it works for any piece with extras.

## Set it up

1. Add the **Add-on builder** section and choose the **Base piece**.
2. Set **Most add-ons in a set**, from 1 to 8 (default 5).
3. Upload an **Image** of the set, worn or laid out. Empty uses the base piece's main image.
4. In each **Add-on** block, choose the charm in **Add-on** and add a **Note**, for example "Polished gold".
5. Turn on **In the set to start** for charms chosen when the page opens.

:::note
Charms go in the bag as separate products, so nothing tells your team which charms go on which base piece. If you attach charms before shipping, say so in **Note under the button**.
:::

## Settings

:::details Section settings
| Setting | What it does |
| --- | --- |
| **Color scheme** | Colors of the section. Default scheme 1. |
| **Base piece** | The piece the add-ons go on, for example a bracelet, chain or ring. |
| **Most add-ons in a set** | The most charms a shopper can choose. 1 to 8, default 5. |
| **Image** | The set, worn or laid out. Empty uses the base piece's photo. |
| **Photo position** | Left (default) or Right. |
| **Eyebrow** | Small text above the heading. Default "Style your own". |
| **Heading** | The section heading. |
| **Heading size** | Large, Medium, Small (default) or Extra small. |
| **Text** | A paragraph under the heading. `[max]` shows the most add-ons in a set. |
| **Button label** | The add button's text. Default "Add the set to bag". |
| **Note under the button** | A line of small print under the button. |
| **Top spacing** | None (default), Small, Medium or Large. |
| **Bottom spacing** | None (default), Small, Medium or Large. |
:::

:::details Add-on block settings
| Setting | What it does |
| --- | --- |
| **Add-on** | The charm product. A charm with several variants gets a dropdown in its row. |
| **Note** | A short line under the charm's name. |
| **In the set to start** | Chooses the charm when the page opens. Installs off. If more charms start in the set than **Most add-ons in a set** allows, the first ones in block order are kept. |
:::

Every setting: [Charm builder reference](https://spellnsell.com/themes/kera/docs/reference/sections/charm-builder).

## Good to know

:::details What does the shopper see in each charm row?
Image, linked name, note, price and + / −. When the set is full, other buttons dim and show "Your set holds up to 5 add-ons. Take one off to add another."
:::

:::details What happens with sold-out pieces?
A sold-out charm shows "Sold out" and can't be added; in a charm with variants, sold-out variants are disabled in the dropdown. If the base piece is sold out, the button adds the chosen charms only.
:::

:::details What does the add button put in the bag?
One base piece and one of each chosen charm, each its own line, so one charm can be returned alone. With Theme settings > Buttons > **Show the price on the button**, the total shows on the button. The bag then follows **After adding to the bag** ([Cart drawer and cart page](https://spellnsell.com/themes/kera/docs/cart/cart)).
:::

:::details Can shoppers add more than one of the same charm?
No. Each charm is either in the set or not. For two of the same charm, the shopper can change the quantity in the bag afterward.
:::

:::details Can I give a discount for buying a set?
The section doesn't show or apply one. Set up an automatic discount in Shopify admin > Discounts; the bag and checkout then show it.
:::
