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

# Introduction

> Build custom gift boxes, mix-and-match bundles, and curated product boxes for your WooCommerce store.

BoxBuilder for WooCommerce lets your customers build their own product boxes — pick items, fill the box, and add it to cart as a single product. Perfect for gift boxes, candy boxes, sample packs, hampers, and any "build your own" experience.

## What is BoxBuilder?

BoxBuilder is a WooCommerce plugin by [SwiftlyWP](https://swiftlywp.com) that adds a visual box builder to any WooCommerce product. Your customers browse available products, add items to their box, and checkout — all without leaving the product page.

<CardGroup cols={2}>
  <Card title="Install BoxBuilder" icon="download" href="/plugins/boxbuilder/installation">
    Get BoxBuilder set up on your WordPress site in under 2 minutes.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/plugins/boxbuilder/quickstart">
    Build your first box in 5 minutes.
  </Card>

  <Card title="Features" icon="sparkles" href="/plugins/boxbuilder/creating-a-box">
    Explore box configuration, pricing models, and display options.
  </Card>

  <Card title="Developers" icon="code" href="/plugins/boxbuilder/hooks-and-filters">
    Hooks, filters, template overrides, and REST endpoints.
  </Card>
</CardGroup>

## Who is it for?

* **Gift shops & candy stores** — let customers pick chocolates, sweets, or treats to fill a gift box
* **Florists** — build your own bouquet from available flowers
* **Subscription box companies** — let subscribers customize their monthly box
* **Food & beverage** — sample packs, cheese boards, coffee selections
* **Corporate gifting** — branded gift hampers with curated product choices
* **Any WooCommerce store** that wants a "build your own" product experience

## Free vs Pro

BoxBuilder comes in two versions:

<Tabs>
  <Tab title="Free">
    Everything you need to launch a box-building experience:

    * Create box products with fixed or range-based capacity
    * Fixed price or per-item pricing
    * Grid and list layouts
    * Gift message support
    * Full cart, order, and email integration
    * Shortcode and Gutenberg block
    * Mobile responsive
    * Customizable labels, colors, and appearance
    * 6 settings tabs with full control

    [Download Free on WordPress.org →](https://wordpress.org/plugins/boxbuilder-for-woocommerce/)
  </Tab>

  <Tab title="Pro">
    Everything in Free, plus:

    * Multiple box sizes (Small / Medium / Large)
    * Category filter tabs in product picker
    * Custom text-based items (no WooCommerce products needed)
    * Hybrid pricing (base price + per-item)
    * Analytics dashboard with revenue, fill rates, and popular items
    * Save boxes for later (logged-in users)
    * Shareable box URLs
    * Subscription box mode (with WooCommerce Subscriptions)
    * Multi-currency and WPML support
    * Priority support

    [Get BoxBuilder Pro →](https://swiftlywp.com/plugin/boxbuilder-for-woocommerce/)
  </Tab>
</Tabs>

## Requirements

* WordPress 6.0 or higher
* WooCommerce 7.0 or higher
* PHP 7.4 or higher

<Note>
  BoxBuilder requires WooCommerce to be installed and activated. If WooCommerce is not active, BoxBuilder will deactivate itself and show a helpful notice with a link to install or activate WooCommerce.
</Note>

## How it works

At a high level, BoxBuilder works like this:

<Steps>
  <Step title="Create a box product">
    Create a standard WooCommerce product and enable BoxBuilder on it. Configure the capacity, pricing model, and which products customers can choose from.
  </Step>

  <Step title="Customer builds their box">
    On the product page, customers see a visual builder with a product grid and a box summary panel. They browse, search, and add items until their box is full.
  </Step>

  <Step title="Add to cart and checkout">
    The completed box is added to the WooCommerce cart as a single line item. Box contents are shown in the cart, order confirmation, and emails.
  </Step>
</Steps>

Under the hood, BoxBuilder uses WooCommerce's native cart and order system — no custom database tables. Each item in the box is tracked as a hidden sub-item for proper stock management, while the customer only sees one clean "box" line item.