# Add-on builder

> Shoppers pick a base piece and add charms or other add-ons to it, all added to the bag together.

Source: https://spellnsell.com/themes/kera/docs/reference/sections/charm-builder · Kera 1.0.0 · Updated 2026-11-16

Shoppers pick a base piece and add charms or other add-ons to it, all added to the bag together.

- **Where it can go:** Any page
- **Area:** Jewelry tools
- **File:** `sections/charm-builder.liquid`

## Section settings

| Setting | Type | Default | What it does |
| --- | --- | --- | --- |
| **Color scheme** | Color scheme | Scheme 1 |  |
| **Base piece** | Product |  | The piece the add-ons go on, for example a bracelet, chain or ring. |
| **Most add-ons in a set** | Slider 1 to 8 | 5 |  |

### Image

| Setting | Type | Default | What it does |
| --- | --- | --- | --- |
| **Image** | Image |  | The set, worn or laid out. Empty uses the base piece's photo. |
| **Photo position** | Choice | Left | Options: Left, Right. |

### Text

| Setting | Type | Default | What it does |
| --- | --- | --- | --- |
| **Eyebrow** | Text | Style your own |  |
| **Heading** | Text | Make it yours, one piece at a time |  |
| **Heading size** | Choice | Small | Options: Large, Medium, Small, Extra small. |
| **Text** | Rich text |  | [max] shows the most add-ons in a set. |
| **Button label** | Text | Add the set to bag |  |
| **Note under the button** | Text |  |  |

### Section spacing

| Setting | Type | Default | What it does |
| --- | --- | --- | --- |
| **Top spacing** | Choice | None | Options: None, Small, Medium, Large. |
| **Bottom spacing** | Choice | None | Options: None, Small, Medium, Large. |


## Blocks

:::details Add-on
Type: `_charm-builder-charm`

| Setting | Type | Default | What it does |
| --- | --- | --- | --- |
| **Add-on** | Product |  |  |
| **Note** | Text |  | A short line under the name, for example Polished gold. |
| **In the set to start** | On/off | Off |  |

:::

## Developer notes

Add-on builder (named Charm builder in code): a base piece and up to N add-ons, added to the bag together, each charm as its own line item (assets/charm-builder.js). The charms are theme blocks in blocks/_charm-builder-charm.liquid.
