> 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.md).

# Build-A-Box

Let customers fill their own box from products you choose, then buy it once or as a subscription. Choose between a Dynamic box and a Static box.

**Build-A-Box** lets customers pick the products that go into a box, then buy the box once or subscribe to it. You choose which products customers can pick from, the purchase options, and the rules that set the price.

Use it for meal kits, snack boxes, beauty sets, coffee bundles, or any mix of products that customers like to choose themselves.

## Dynamic box or Static box

When you create a box, you choose one of two box types. You can't change the type after you save the box.

|                       | **Dynamic box**                                                                           | **Static box**                                                                        |
| --------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| What customers pay    | The price of each item they add.                                                          | A fixed price for the box size they choose. The items inside are free.                |
| How the price changes | Tiered discounts: the box gets a discount when it reaches a number of items or an amount. | Each box size has its own price, for example 1–3 items for $30 and 4–6 items for $50. |
| Box size              | A minimum and an optional maximum, counted in items or in money.                          | A minimum and an optional maximum number of items for each size.                      |
| Best for              | Encouraging customers to add more items.                                                  | Simple, predictable pricing.                                                          |

To set up each type, see [Dynamic Box](https://subscriptions-docs.tech-arms.io/features/build-a-box/dynamic-box.md) and [Static Box](https://subscriptions-docs.tech-arms.io/features/build-a-box/static-box.md).

## The box list

In the app menu, click **Build a Box**. The **Build-A-Box** page lists all your boxes with their **Name**, **Status**, **Type**, and **Created at** date.

![The Build-A-Box list with the tabs and the Create Box button highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FI49DKTAAoQKOz4fev0xI%2Fbuild-a-box-list.png?alt=media)

* Use the tabs **All**, **Active**, **Draft**, **Dynamic**, and **Static** to filter the list, or search by name.
* Click a box to open and edit it.
* In the **Action** column:
  * **Copy Link** copies the link to the box page on your storefront.
  * **Duplicate** creates a copy of the box, named " copy", with its own new box product.
  * **Delete** deletes the box.
* Click **Create Box** to create a new box.

{% hint style="danger" %}
Deleting a box also deletes its box product and its selling plans in Shopify. Customers who already subscribed to the box may be affected. If people are subscribed to a box, set it to **Draft** instead of deleting it, or contact us first.
{% endhint %}

## What happens when you save a box

When you save a box, the app:

* creates a **box product** in Shopify with the box name. A Static box gets one variant per box size, priced at the box price,
* creates the box's selling plans and adds them to the box product and to the products customers can pick,
* creates an automatic discount called **TA SUBSCRIPTIONS APP BUILD A BOX DISCOUNT** (on older stores: **EASTO BUILD A BOX DISCOUNT**) that applies the box price or the box discount at checkout.

The selling plans of a box are only used by the box. They don't appear in **Selling Plans** or in the subscription widget on your product pages.

{% hint style="warning" %}
Don't turn off or delete the **TA SUBSCRIPTIONS APP BUILD A BOX DISCOUNT** discount in **Shopify admin > Discounts**. Without it, customers pay the full price of every item, and saving the box again does not turn it back on.
{% endhint %}

## Where customers find the box

Each box has its own page on your storefront. It works without logging in. You can share it in two ways.

### Share the box link

Open the box and find the **Build-A-Box Link** card on the right. Click the copy icon to copy the link, or click **View** to open the box page in a new tab. You can also click **Copy Link** in the box list.

Add the link to your menu, a banner, a button, or an email.

![The Build-A-Box Link card with the copy icon and the View button highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FW6ZZ1KKgagMSNwon6z2d%2Fbuild-a-box-link-card.png?alt=media)

{% hint style="info" %}
The link appears after you save the box while it is **Active**. Until then, the card says "Build-A-Box needs to be activated and published in order for the link to be generated."
{% endhint %}

### Add a button to the box product page

The box product is a normal product in your store. Add the **Box Button** app block to its product page so customers can open the box from there:

1. In Shopify admin, go to **Online Store > Themes** and click **Customize**.
2. Open the product template used by the box product.
3. Click **Add block**, then **Apps**, and choose **Box Button**.
4. Change the button text in the block's **Text** setting. The default is **Customize My Box**.
5. Click **Save**.

The button only shows on products that are linked to a box. On those products, it also hides the theme's own add to cart form, so customers can't buy the box product without filling the box. To give the box product a picture and description, open the box and click **Edit on Shopify** in the **Box Product** card.

## How customers buy a box

1. The customer opens the box page.
2. They pick items from the products you chose. On a Static box, they choose a box size first.
3. They choose a purchase option: **One-time purchase** or one of the box's selling plans.
4. When the box meets your rules, they click **Proceed to Checkout**.

The customer's cart is emptied, the box and its items are added, and the checkout opens. The box price or box discount is applied at checkout.

![The box page on the storefront with products and the box summary](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FYoKCSQ77IhXb4NlTDqJi%2Fbuild-a-box-storefront.png?alt=media)

{% hint style="warning" %}
Checking out a box empties the customer's cart, including products they added earlier. Tell customers to check out the box separately.
{% endhint %}

## Change the words on the box page

To change or translate the words on the box page, such as "Build Your Box", "Your box", or "Proceed to Checkout", see [Multilingual pages](https://subscriptions-docs.tech-arms.io/features/translation/translation.md). The words are in the **Build A Box** group.

## Limits

* **Box type can't be changed** after the first save. To switch, create a new box.
* **The box name can't be edited** after the first save. If you rename the box product in Shopify, the app sets the name back the next time you save, activate, or deactivate the box.
* **Customers can't rebuild a box after they subscribe.** If **Edit upcoming order** is turned on in the [Customer Portal](https://subscriptions-docs.tech-arms.io/features/customer-portal.md), they can change quantities or remove items, but the box rules are not checked again.
* **Changing the cart after leaving the box page can remove the box price.** If a customer removes the box product, or changes quantities so the box no longer meets its rules, the box discount is removed at checkout.
* **No Free Gift and no Try Before You Buy** for boxes. Box selling plans can't be chosen in a [Free Gift](https://subscriptions-docs.tech-arms.io/features/free-gift.md) campaign.
* Each box can have up to **20 selling plan options**.

## Good to know

* A new box is **Active** by default. Click **Deactivate** at the top of the box page to hide it. A box in **Draft** shows "Box Not Yet Published" to customers.
* If you create a box in **Draft** and activate it later, the box product is not published to your online store automatically. Open the box product in Shopify admin and make it available on the **Online Store** sales channel. Otherwise customers see "Box Not Yet Published".
* A box can only be bought from its box page. The **Box Button** block and the box link both lead there.

*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.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.
