> For the complete documentation index, see [llms.txt](https://subscriptions-docs.tech-arms.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://subscriptions-docs.tech-arms.io/features/build-a-box/dynamic-box.md).

# Dynamic Box

Let customers fill a box with the items they want, pay for each item, and get a bigger discount as the box grows.

In a **Dynamic box**, customers pay the price of each item they add. You set discount tiers, for example 10% off from 3 items and 15% off from 6 items. As the box grows, customers see the next discount they can unlock, which encourages them to add more.

For the difference with a Static box, see [Build-A-Box](https://subscriptions-docs.tech-arms.io/features/build-a-box.md).

## Create a Dynamic box

{% stepper %}
{% step %}

### Open a new box

In the app menu, click **Build a Box**, then **Create Box**. A new box opens with **Dynamic box** selected.

As you fill in the form, the summary card on the right shows the box type, items, purchase options, box size, and discounts.
{% endstep %}

{% step %}

### Name the box and choose the type

In the **Box Product** card:

* **Box Name**: the name customers see, for example "Magic Mix Box". The app uses it as the name of the box product in Shopify.
* **Box type**: keep **Dynamic box** selected.

![The Box Product card with the Box Name field and the Dynamic box option highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FgwtlZvcSTNyFtSKtm9cI%2Fdynamic-box-product-card.png?alt=media)

{% hint style="warning" %}
You can't change the box name or the box type after you save the box. If you switch the type before saving, the window **Change box type?** warns you that everything you entered is cleared.
{% endhint %}
{% endstep %}

{% step %}

### Choose the items customers can pick

In **Apply To**, choose what customers can put in the box:

* **Products** tab: pick whole products.
* **Variants** tab: pick single variants.

You can use both tabs. Each tab shows how many items are selected. You must select at least one item.
{% endstep %}

{% step %}

### Set the purchase options

In **Configure Selling Plans**:

| Setting                     | What it does                                                                                                                                            |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Allow One-time Purchase** | Customers can buy the box once, without a subscription. When this is on, every item in the box must also be available for one-time purchase in Shopify. |
| **Selling Plan Options**    | The subscription options customers can choose, for example "Deliver every month, 10% off". A new box starts with one option.                            |

To edit a plan option, click its name or the edit icon. The fields are the same as on a selling plan. See [Create a selling plan](https://subscriptions-docs.tech-arms.io/features/subscription/how-to-create-a-subscription-plan.md). Click **Add** to add a plan option, or **Import existing options** to copy options from one of your selling plans. You can add up to 20 plan options.

If you turn off **Allow One-time Purchase**, the box needs at least one plan option.

![The Configure Selling Plans card with Allow One-time Purchase and a plan option opened](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FIV00ZagZGZewAVsoXyxA%2Fdynamic-box-selling-plans.png?alt=media)
{% endstep %}

{% step %}

### Set the box rules

In **Box Rules**, set how big the box can be and the discount customers get.

**Calculate by** decides how both the box size and the discount tiers are measured:

| Option                                             | The box is measured by                                           |
| -------------------------------------------------- | ---------------------------------------------------------------- |
| **Total number of items**                          | The number of items in the box.                                  |
| **Total cost after selling plan option discount**  | The total price of the items, after the plan option's discount.  |
| **Total cost before selling plan option discount** | The total price of the items, before the plan option's discount. |

**Box size**:

| Field                                                     | What it does                                  |
| --------------------------------------------------------- | --------------------------------------------- |
| **Min items** or **Min total cost**                       | The smallest box customers can check out.     |
| **Max items (optional)** or **Max total cost (optional)** | The largest box. Leave it empty for no limit. |

**Discount tiers**: click **Add** to add a tier. You can add up to 20 tiers. For each tier, fill in:

| Column                                     | What it does                                             |
| ------------------------------------------ | -------------------------------------------------------- |
| **When box has** or **When total reaches** | The number of items or the amount that unlocks the tier. |
| **Discount type**                          | **Percentage** or **Fixed**.                             |
| **Customer gets**                          | The discount, as a percentage or an amount.              |

Under each tier, **Applies to** shows the range the tier covers, for example "3–5 items" or "6+ items".

If a tier uses **Fixed**, the option **Apply fixed discount to each item** appears:

* turned on: the fixed amount is taken off each item in the box,
* turned off: the fixed amount is taken off once.

![The Box Rules card with Calculate by, the box size fields, and two discount tiers](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FIIoQPNgh5SsyVDx8DfH8%2Fdynamic-box-rules.png?alt=media)

{% hint style="info" %}
Only the highest tier the box reaches applies. Tiers do not add up. For example, with 10% off from 3 items and 15% off from 6 items, a box of 7 items gets 15% off, not 25%.
{% endhint %}
{% endstep %}

{% step %}

### Save and share the box

Click **Save**. The box is **Active** by default and the box product is published to your online store.

Copy the link from the **Build-A-Box Link** card, or click **View** to open the box page. To let customers open the box from the box product page, add the **Box Button** app block. See [Build-A-Box](https://subscriptions-docs.tech-arms.io/features/build-a-box.md).
{% endstep %}
{% endstepper %}

## Rules the app checks

The form marks a field in red when:

* the box has no name or no items,
* there is no discount tier, or two tiers start at the same value,
* a **Percentage** discount is not between 0 and 100,
* the maximum is smaller than the minimum or than the highest tier,
* the minimum is larger than the lowest tier.

Fix the fields in red before you save. If the box can't be saved, an error message appears at the top of the page.

## What customers see

On the box page, customers see the **Build Your Box** page with the products you chose and a **Tiered discount** bar. The bar shows the next discount and how much more they need to add.

When they click **Add** the first time, the **Your box** panel opens. In it, they can:

* change quantities or remove items,
* choose **One-time purchase** or a selling plan option,
* see the **Box discount tiers** and the **Subtotal**,
* click **Proceed to Checkout**.

**Proceed to Checkout** works only when the box is between your minimum and maximum. At checkout, the discount of the tier the box reached is applied.

![The Your box panel on the storefront with the selling plan options and the discount tiers](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FaZ91JPA454Z38Pp6jccA%2Fdynamic-box-storefront-cart.png?alt=media)

{% hint style="warning" %}
If a box is outside the minimum and maximum at checkout, for example because the customer changed the cart, no box discount is applied.
{% endhint %}

## Good to know

* With **Total cost** options, the amounts use your store currency.
* To change the words on the box page, such as "Tiered discount" or "Your box", see [Multilingual pages](https://subscriptions-docs.tech-arms.io/features/translation/translation.md).
* Try Before You Buy and Free Gift are not available for boxes.

*If you need help, feel free to reach out to us via in-app* [***Live chat***](https://go.crisp.chat/chat/embed/?website_id=c4ae10a3-f762-4968-b35a-c931caf62a96)***,*** [***Book a call***](https://calendly.com/ta-subscription-app-support/30min) *or at* [***support@tech-arms.io***](mailto:support@tech-arms.io)***.***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://subscriptions-docs.tech-arms.io/features/build-a-box/dynamic-box.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
