---
title: "Static Build-a-Box setup guide"
slug: "static-build-a-box-setup-guide"
description: "Create customizable subscription bundles with Static Build-a-Box. Customers choose products at a fixed price, enhancing personalization and retention."
updated: 2026-03-26T18:33:07Z
published: 2026-03-26T18:33:07Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.skio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Static Build-a-Box setup guide

## How does a Static Build-a-Box work?

Static boxes let you offer subscription boxes with fixed quantities at set prices. You define the box sizes and prices upfront, and customers choose which products fill each box. The price stays the same on every recurring order regardless of which products the customer selects.

There are two sizing mechanics:

- **Fixed box size:** Customers must fill exactly one box size (e.g., 6 products for $50). Best when you only want to offer a single option.
- **Multiple size with fixed price:** Customers choose from preset box sizes, each with its own quantity and price (e.g., 4 items for $40, 6 items for $60, 8 items for $80). Best when you want to give customers flexibility across tiers.

Both mechanics follow the same setup flow. The only difference is whether customers get one size option or multiple.

> [!NOTE]
> View the [customer-facing storefront guide here](/help/docs/build-a-box-customer-experience).

## How to set up a Static Build-a-Box

### Step 1: Navigate to Build-a-Box

1. In the left-hand menu of your **Skio Dashboard**, go to **Acquire** > **Build-a-Box**.
2. Click **+ New box**.

![](https://cdn.us.document360.io/a953bba6-c70d-43ce-bc77-d7f32a8fc514/Images/Documentation/image(63).png)

### Step 2: Select your box style

1. You'll land on the **Select a box style** screen (Step 1 of 3).
2. Choose **Static box**.
3. Click **Next**.

![](https://cdn.us.document360.io/a953bba6-c70d-43ce-bc77-d7f32a8fc514/Images/Documentation/CleanShot 2026-02-26 at 11.06.44.png)

### Step 3: Configure your box

This is Step 2 of 3 in the setup flow. The page has five sections. A live **Preview** panel on the right side updates as you make changes, so you can see the customer experience in real time. Note that the preview won't load until you've added at least one box size.

#### Basic info

- **Box name** (required): This is both the internal name and the customer-facing name. It also syncs to the Shopify product page.
- **Internal description:** Notes for your team. Not shown to customers.
- **Box image:** Upload the image that displays on your storefront and Shopify product page. Supported formats are SVG, PNG, JPG, or GIF (max 800x400px). This syncs to Shopify automatically.

#### Box Mechanics

This is where you define your box sizing and pricing.

1. Choose your sizing mechanic: **Fixed box size** or **Multiple size with fixed price**.
2. Set the **Box size** fields by entering the number of items and the price for each size. If you chose **Multiple size with fixed price**, add as many size options as you need. You can also click **Templates** next to the Box size heading to start from a pre-built configuration.

|  | Fixed box size | Multiple size with fixed price |
| --- | --- | --- |
| **How it works** | One box size with a set quantity and price | Multiple box sizes, each with its own quantity and price |
| **Best for** | Simple offerings with a single option | Giving customers flexibility across price points |
| **Example** | 6 items for $50 | 4 items for $40, 6 items for $60, 8 items for $80 |

![](https://cdn.us.document360.io/a953bba6-c70d-43ce-bc77-d7f32a8fc514/Images/Documentation/CleanShot 2026-02-26 at 11.08.50.png)

An example of a Static box with multiple sizes with fixed prices.

#### Eligible items for the box

These are the products customers can choose to fill the box.

- Click **Select products or categories** to add items.
- Drag products to reorder how they appear on the Buy page.
- Optionally, toggle **Group by categories** to organize the product display into sections on the Buy page.

#### One-time upsell items (optional)

These are optional add-on items offered after the box is filled. They're separate from the box contents and billed as one-time purchases.

Click **Select products or categories** to add upsell items.

![](https://cdn.us.document360.io/a953bba6-c70d-43ce-bc77-d7f32a8fc514/Images/Documentation/CleanShot 2026-02-19 at 11.49.13@2x.png)

How One-time add-ons appear to the customer on the Buy pages.

#### Customize your Buyer Page Content

Control the text and settings your customers will see on the Buy page.

- Toggle **Use default Skio copy** on to use Skio's standard text. Turn it off to customize the following fields:
  - **Header** and **Subheader**
  - **Customer portal box title**
  - **One time upsell header** and **One time upsell subheader**
  - **Discount title**
- **Display settings:**
  - **Display variants as separate cards:** Show each variant as its own card instead of grouping under one product.
  - **Default to one time purchase:** Pre-select the one-time purchase option instead of subscription.
  - **Redirect to cart:** Send customers to the cart page after adding the box instead of going straight to checkout.
  - **Show parent box view:** Display the parent box view in the customer portal.
  - **Hide item child price (customer portal):** Hide individual item prices in the customer portal.

Once everything looks good in the **Preview** panel, click **Next**.

### Step 4: Link a Selling Plan (optional)

This is Step 3 of 3. Connecting a Selling Plan makes the box available as a subscription. If you don't set a Selling Plan, the box will only be available as a one-time purchase.

You have two options:

- **Select an existing Selling Plan** from the dropdown, or
- Click **Create new selling plan** to build one inline

If you're not ready to add a Selling Plan yet, click **Skip**. You can always add one later from the three-dot menu on the box card.

Click **Confirm** to publish the box.

![](https://cdn.us.document360.io/a953bba6-c70d-43ce-bc77-d7f32a8fc514/Images/Documentation/CleanShot 2026-02-19 at 12.02.03@2x.png)

### Step 5: Add the Build-a-Box code to your Shopify theme

> [!NOTE]
> No developer needed for this part. You'll add a short code snippet directly in the Shopify theme editor to enable the box customization experience on your product page.

1. In your **Shopify Admin**, go to **Online Store** > **Themes**.
2. Find your live theme and click **Customize**.
3. Using the dropdown in the top center of the editor, navigate from the home page to **Products** > **Default product**.
4. In the left-hand panel under **Product information**, click **Add block** > **Custom Liquid**.
5. Copy and paste the code snippet below into the block, then click **Save**.

```plaintext
{% if product.type == 'Classic Box' or product.type == 'Dynamic Box' %} 
  <script> 
    (() => { 
      document.addEventListener('DOMContentLoaded', () => { 
        const form = document.querySelector('form[action="/cart/add"]'); 
        if(!form) { console.error('Skio: No form found'); return; } 
        const addToCart = form.querySelector('button[type="submit"]'); 
        if(!addToCart) { console.error('Skio: No add to cart button found'); return; } 
        const customize = addToCart.cloneNode(true); 
        customize.removeAttribute('name'); 
        customize.type = 'button'; 
        customize.querySelector('span').innerHTML = 'Customize my Box'; 
        customize.addEventListener('click', (event) => { 
          const formData = new FormData(form); 
          const variant = formData.get('id'); 
          const sellingPlan = formData.get('selling_plan');
          let redirect;
          {% if product.type == 'Classic Box' %} 
            if (sellingPlan) { redirect = `/a/account/custom-tools/build-a-box?variant=${variant}&selling_plan=${sellingPlan}`; } 
            else { redirect = `/a/account/custom-tools/build-a-box?variant=${variant}`; }
          {% else %} 
            redirect = `/a/account/custom-tools/dynamic-box?product={{product.id}}`; 
          {% endif %} 
          window.location = redirect; 
        }); 
        const buttonParent = addToCart.parentElement; 
        buttonParent.insertBefore(customize, addToCart); 
        addToCart.remove(); 
        let remove_button = form.querySelector('[data-shopify="payment-button"]'); 
        if (remove_button) remove_button.remove(); 
      }); 
    })(); 
  </script> 
{% endif %}
```

## After setup

> [!NOTE]
> View the [customer-facing storefront guide here](/help/docs/build-a-box-customer-experience).

After saving, you'll be redirected to the **Build-a-Box** list view. Your sectioned box will appear as a **Draft**.

![](https://cdn.us.document360.io/a953bba6-c70d-43ce-bc77-d7f32a8fc514/Images/Documentation/CleanShot 2026-02-19 at 12.02.48@2x.png)

From the **Build-a-Box** list view, click the **three-dot menu** on your box card to:

- **Edit:** Reopen the box setup to make changes.
- **Duplicate:** Copy the box as a starting point for a new one.
- **View in Shopify:** Jump to the product in Shopify admin.
- **Customer View:** Preview the Buy page as a customer sees it on your storefront.
- **Disable:** Set the box to Draft in Shopify (removes it from the store).
- **Delete:** Permanently remove the box.

## How static box orders appear in Shopify

When a static box subscription bills, Skio creates the Shopify order with two types of line items:

- **Parent line item:** The box product itself, charged at the full box price.
- **Child line items:** One per product in the box, each priced at $0.

The parent line represents what the customer paid for. The child lines tell your fulfillment team exactly which products to pick and pack. The $0 pricing on child lines is intentional. The customer is only charged once, through the parent box line.

![Order summary showing Cloudwell products and customer details for shipping.](https://cdn.us.document360.io/a953bba6-c70d-43ce-bc77-d7f32a8fc514/Images/Documentation/CleanShot 2026-03-26 at 14.31.26.png)

## Considerations

- **Boxes with active subscribers are locked from editing.** If you need to make changes to a box that already has subscribers, you'll need to duplicate it and create a new version.
- **Editing pricing on a live box** triggers a prompt asking whether to apply changes to all subscriptions (existing and new) or new subscriptions only. Applying to all will notify existing subscribers, so choose carefully.
- **If Shopify publish fails,** the box saves as a Draft with a retry message. Try publishing again, and if it persists, contact support.
- **Only admin-level users** can publish to Shopify or create/edit Selling Plans.
- **Selling Plans sync both ways.** Changes you make in Build-a-Box are reflected in **Products** > **Selling Plans**, and vice versa.