> 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/static-box.md).

# Static Box

Offer box sizes at fixed prices. Customers choose a size, then fill the box with the items they want.

In a **Static box**, you set box sizes with a fixed price each, for example 1–3 items for $30 and 4–6 items for $50. Customers choose a size, then pick items up to that size. They pay the box price, and the items inside are free.

Static boxes keep pricing simple: customers know the price before they start filling the box.

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

## Create a Static 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. You switch to Static in the next step.

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

{% step %}

### Name the box and choose the type

In the **Box Product** card:

* **Box Name**: the name customers see, for example "Daily Glow Box". The app uses it as the name of the box product in Shopify.
* **Box type**: select **Static box**.

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

{% hint style="warning" %}
Choose the type before you fill in the rest of the form. Switching the type opens the window **Change box type?**, and clicking **Change type** clears everything you entered. After you save, the box name and type can't be changed.
{% 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. 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. A plan option's discount is taken off the box price. 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.
{% endstep %}

{% step %}

### Set box sizes and prices

In **Box Rules**, under **Box size and price**, each row is one box size:

| Column           | What it does                                                 |
| ---------------- | ------------------------------------------------------------ |
| **Min quantity** | The fewest items for this size.                              |
| **Max quantity** | The most items for this size. Leave it empty for no limit.   |
| **Price**        | The price customers pay for the box, in your store currency. |

Click **Add** to add a size, up to 20 sizes. Click the delete icon to remove one.

![The Box Rules card with three box sizes and their prices](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FyDyZY7X8auxeTiztR08a%2Fstatic-box-sizes.png?alt=media)

{% hint style="warning" %}
Box sizes can't overlap, and they can't share a number either. Use 1–3 and 4–6, not 1–3 and 3–5. Otherwise the form shows "Box size ranges can't overlap" and the box is not saved.
{% 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. The box product gets one variant per box size, priced at the box price.

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 %}

## What customers see

1. On the box page, customers see **Choose your box size** and pick a size.
2. They search and pick items under **Choose Products**.
3. The box summary next to the products shows the **Size**, the purchase options, the **Current Box Items**, and the **Total**.
4. When the number of items fits the size, they click **Proceed to Checkout**.

Customers can't add more items than the size allows. At checkout, they pay the box price, with the plan option's discount if they subscribe, and the items in the box are free.

![The Static box page on the storefront with a box size selected and items in the box](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FfpueyOaMH6iROrkiGzUn%2Fstatic-box-storefront.png?alt=media)

{% hint style="warning" %}
If a customer changes the cart after leaving the box page, for example by removing the box product or adding items so the box no longer fits its size, the items are no longer free. They are charged at full price on top of the box price.
{% endhint %}

## Good to know

* The texts "Selling plan options", "Select a selling plan", and "One-time purchase" on the Static box page can't be translated yet. To change the other words on the box page, 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.
* To add a picture to the box, open the box and click **Edit on Shopify** in the **Box Product** card.

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