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.

View the customer-facing storefront guide here.

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.

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.

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.

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.

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

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.

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

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.

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

View the customer-facing storefront guide here.

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

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.

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.