# smootify-magic-box

> Build-a-box: the add-to-cart forms inside it add to the box instead of the cart. 2.0: its pieces stay through a reload or another page until the box goes to the cart (a week at most); the card (smootify-product) of a picked product takes is-in-box and data-in-box (how many of it); the total takes the box's discount only once the box can be bought.

Status: Ready (Smootify 2.0)  
Add-on: Magic Box  
URL: https://www.smootify.io/docs/astro/reference/elements/smootify-magic-box  
Updated: 2026-10-21

## Where it can go

- **Anywhere** on the page.
- **Must contain** [`smootify-magic-box-cart`](https://www.smootify.io/docs/astro/reference/elements/smootify-magic-box-cart).
- **Out of place,** Smootify removes it from the page: also when the data-handle metaobject does not exist.

## What it requires

- The **Magic Box** extension (the extension activated in the Smootify dashboard, on every plan). Without it, the element does nothing.

## Attributes on the element

- **It reads** `data-handle`, `data-title`, `data-image`, `data-min`, `data-max`, `data-step`, `data-unique`, `data-unique-per-category`, `data-all-categories`, `data-auto-remove-category`, `data-only-one`, `data-only-one-per-category`, `data-full-error`, `data-too-many-error`.

## Attributes inside it

| Group | Attribute name | Values |
|---|---|---|
| [Magic box category (condition)](https://www.smootify.io/docs/astro/reference/conditions/magic-box-category) | `box-condition` | 2 |