---
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."
tags: ["BAB", "Build-a-Box"]
updated: 2026-10-19T21:12:00Z
published: 2026-10-19T21:12:00Z
canonical: "help.skio.com/static-build-a-box-setup-guide"
---

> ## 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

Static boxes let you offer subscription boxes with fixed quantities at set prices. You define the box sizes and prices upfront, and the price stays the same on every recurring order. You also choose who decides what goes in the box:

- **Customizable:** Customers choose which products fill the box when they buy, and can change them afterward.
- **Preset:** You choose the exact products and quantities for each box size. Every customer receives the same contents, and customers can't change them. This works like a preset bundle in other subscription apps.

There are also 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.

> [!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?sv=2026-02-06&spr=https&st=2026-11-02T08%3A23%3A14Z&se=2026-11-02T09%3A23%3A14Z&sr=c&sp=r&sig=2h93JAlb%2F6KI50RQygbHEeBSq5OFa4wsvj3yCbUUfuE%3D)

### 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?sv=2026-02-06&spr=https&st=2026-11-02T08%3A23%3A14Z&se=2026-11-02T09%3A23%3A14Z&sr=c&sp=r&sig=2h93JAlb%2F6KI50RQygbHEeBSq5OFa4wsvj3yCbUUfuE%3D)

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

#### Contents control

Contents control sets who decides what's inside the box. Choose one option:

- **Customizable:** Customers pick products from the eligible items you select. This is the default.
- **Preset:** You set the exact products and quantities for each box size. Customers buy the box as-is.

#### Box Mechanics

This is where you define your box sizing and pricing. The fields you fill in depend on your sizing mechanic and your **Contents control** choice.

First, choose your sizing mechanic: **Fixed box size** or **Multiple size with fixed price**.

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

Then set up your sizes. You can click **Templates** in either setup to start from a pre-built configuration.

**If you chose Customizable**, you'll see a **Box size** section (for a fixed box size) or a **Size options** section (for multiple sizes). You only set the quantity and price here. Customers pick the products from your eligible items.

1. Enter the **Size (items)** and **Price**.
2. If you chose **Multiple size with fixed price**, click **Add another tier** for each additional size.

**If you chose Preset**, you'll see a **Sizes & contents** section instead. Each size is a card where you set the quantity, price, and the exact products customers receive.

1. Click the **edit** icon on a size card.
2. Enter the number of items and the price for that size.
3. Select the products and quantities included in that size.
4. If you chose **Multiple size with fixed price**, repeat for each size card. To remove a size, click the **delete** icon on its card.

> [!WARNING]
> **Preset box contents can't be edited for individual subscribers.** Contents come from your box setup. You can't edit them on a single subscription in the **Skio Dashboard**, and subscribers can't edit them in the Customer Portal. You can still remove a preset box from a subscription. Preset boxes also aren't offered as swap options in Cancel Flow.

#### Eligible items for the box

> [!NOTE]
> **Note:** Eligible items only apply to **Customizable** boxes. Preset box contents are set in **Sizes & contents**.

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?sv=2026-02-06&spr=https&st=2026-11-02T08%3A23%3A14Z&se=2026-11-02T09%3A23%3A14Z&sr=c&sp=r&sig=2h93JAlb%2F6KI50RQygbHEeBSq5OFa4wsvj3yCbUUfuE%3D)

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?sv=2026-02-06&spr=https&st=2026-11-02T08%3A23%3A14Z&se=2026-11-02T09%3A23%3A14Z&sr=c&sp=r&sig=2h93JAlb%2F6KI50RQygbHEeBSq5OFa4wsvj3yCbUUfuE%3D)

### 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?sv=2026-02-06&spr=https&st=2026-11-02T08%3A23%3A14Z&se=2026-11-02T09%3A23%3A14Z&sr=c&sp=r&sig=2h93JAlb%2F6KI50RQygbHEeBSq5OFa4wsvj3yCbUUfuE%3D)

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?sv=2026-02-06&spr=https&st=2026-11-02T08%3A23%3A14Z&se=2026-11-02T09%3A23%3A14Z&sr=c&sp=r&sig=2h93JAlb%2F6KI50RQygbHEeBSq5OFa4wsvj3yCbUUfuE%3D)

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