Build-a-Box

Create subscription box builders with step-by-step customization

Last updated: 2025-01-16

Build-a-Box is a guided bundle builder designed for subscription boxes. Customers step through categories, selecting items for their personalized subscription box. Perfect for snack boxes, beauty boxes, wellness boxes, and any curated subscription offering.

Subscription Integration

Build-a-Box integrates seamlessly with Chargezen Subscriptions. Customers can build their box once and have it delivered on a recurring schedule.

How Build-a-Box Works

  1. Customer starts the builder — Lands on the Build-a-Box page
  2. Steps through categories — Selects items from each category
  3. Sees running total — Box value updates as they add items
  4. Chooses frequency — One-time or subscription
  5. Adds to cart — Complete box ready for checkout

Perfect For

Build-a-Box Use Cases

  • Snack subscription boxes
  • Beauty/skincare sample boxes
  • Coffee or tea variety boxes
  • Pet treat boxes
  • Wellness supplement boxes
  • Baby product boxes
  • Craft supply boxes
  • Gourmet food boxes

Creating a Build-a-Box

1

Create New Build-a-Box

Go to CheckoutOS → Dynamic Bundles → Create Bundle → Build-a-Box.
2

Define Box Size

Set the total number of items and box price.
3

Create Categories

Add categories (e.g., "Snacks", "Drinks", "Treats") with item limits.
4

Add Products to Categories

Assign products to each category.
5

Configure Subscription Options

Set available frequencies and subscription pricing.
6

Design the Builder

Customize the step-by-step UI.
7

Test & Publish

Walk through the builder as a customer, then publish.

Box Structure

Build-a-Box Configuration
{
  "build_a_box": {
    "name": "Monthly Snack Box",
    "total_items": 8,
    "pricing": {
      "one_time": 39.99,
      "subscription": 34.99,
      "subscription_discount": "Save $5/month"
    },
    "categories": [
      {
        "name": "Sweet Snacks",
        "min_items": 2,
        "max_items": 4,
        "products": ["cookies-001", "chocolate-002", "candy-003"]
      },
      {
        "name": "Savory Snacks",
        "min_items": 2,
        "max_items": 4,
        "products": ["chips-001", "pretzels-002", "nuts-003"]
      },
      {
        "name": "Drinks",
        "min_items": 1,
        "max_items": 2,
        "products": ["soda-001", "juice-002", "water-003"]
      },
      {
        "name": "Bonus Item",
        "min_items": 0,
        "max_items": 1,
        "products": ["mystery-001", "seasonal-002"]
      }
    ]
  }
}

Subscription Options

Configure how subscription delivery works:

Subscription Configuration
{
  "subscription": {
    "enabled": true,
    "frequencies": [
      { "value": "1_week", "label": "Weekly", "discount": 0 },
      { "value": "2_weeks", "label": "Every 2 Weeks", "discount": 5 },
      { "value": "1_month", "label": "Monthly", "discount": 10 }
    ],
    "default_frequency": "1_month",
    "allow_one_time": true,
    "allow_box_changes": true,
    "change_deadline_days": 3
  }
}
Editing Subscriptions

Customers can modify their box contents before each delivery through the Chargezen customer portal. Set a deadline (e.g., 3 days before fulfillment) for changes.

Builder UI

The Build-a-Box wizard guides customers through selection:

UI Features

  • Step-by-step category navigation
  • Progress bar showing completion
  • Running item count and box preview
  • Category requirements ("Pick 2-4 items")
  • Visual product cards with images
  • Mobile-friendly swipe navigation
  • Summary page before checkout
Builder UI Configuration
{
  "ui": {
    "style": "wizard",
    "show_progress_bar": true,
    "show_box_preview": true,
    "preview_position": "sidebar",
    "navigation": "steps",
    "allow_skip": false,
    "show_category_requirements": true,
    "product_card_size": "medium",
    "summary_page": true
  }
}

Fulfillment Integration

Build-a-Box orders include all the information your fulfillment team needs:

  • Individual items listed as line items
  • Box type and subscription status in order notes
  • Special packing instructions if configured
  • Integration with ShipStation, ShipBob, etc.

Best Practices

Optimization Tips
  • Limit categories to 3-5 — Too many steps causes drop-off
  • Offer a "curated" option — Pre-built box for those who don't want to choose
  • Show best sellers — Highlight popular items in each category
  • Use high-quality images — Visual appeal drives selection
  • Incentivize subscriptions — Offer meaningful discount for recurring
  • Mobile-first design — Most box subscribers are on mobile

Related Topics

Was this page helpful?

Need more help? Contact support