Title: BoxBuilder for WooCommerce
Author: SwiftlyWP
Published: <strong>Me 21, 2026</strong>
Last modified: Me 25, 2026

---

Search plugins

![](https://ps.w.org/boxbuilder-for-woocommerce/assets/banner-772x250.png?rev=3542622)

![](https://ps.w.org/boxbuilder-for-woocommerce/assets/icon-256x256.png?rev=3542622)

# BoxBuilder for WooCommerce

 By [SwiftlyWP](https://profiles.wordpress.org/theswiftlywp/)

[Download](https://downloads.wordpress.org/plugin/boxbuilder-for-woocommerce.1.0.1.zip)

 * [Details](https://hat.wordpress.org/plugins/boxbuilder-for-woocommerce/#description)
 * [Reviews](https://hat.wordpress.org/plugins/boxbuilder-for-woocommerce/#reviews)
 *  [Installation](https://hat.wordpress.org/plugins/boxbuilder-for-woocommerce/#installation)
 * [Development](https://hat.wordpress.org/plugins/boxbuilder-for-woocommerce/#developers)

 [Support](https://wordpress.org/support/plugin/boxbuilder-for-woocommerce/)

## Description

**BoxBuilder for WooCommerce** is a powerful, easy-to-use plugin that lets your 
customers build custom gift boxes and product bundles directly on your WooCommerce
store.

Perfect for candy shops, chocolate stores, gift hamper businesses, flower shops,
bakeries, and any store that offers mix-and-match products — BoxBuilder gives your
customers an interactive experience to create personalized gift boxes.

#### How It Works

 1. **Create a Box Product** — Go to WooCommerce Products, enable BoxBuilder on any
    product, and configure the box capacity and pricing
 2. **Choose Available Products** — Select which products or categories customers can
    pick from
 3. **Customers Build Their Box** — An interactive builder lets customers browse products
    by category, search, and add items to their box
 4. **Add to Cart & Checkout** — The completed box goes into the WooCommerce cart with
    full contents visible through checkout, order emails, and admin

#### Key Features (Free Version)

**Box Configuration**

 * **Enable on Any Product** — Turn any WooCommerce product into a customizable 
   gift box with a single toggle
 * **Flexible Capacity** — Set a fixed box size (e.g., 12 items) or a range (e.g.,
   6 to 12 items)
 * **Two Pricing Models** — Fixed price for the whole box, or per-item pricing that
   totals as items are added
 * **Product Sources** — Allow all products, filter by category, or hand-pick specific
   products
 * **Shortcode** — Place the builder anywhere with `[boxbuilder id="123"]`
 * **Gutenberg Block** — Native block editor support for modern WordPress

**Customer Experience**

 * **Interactive Product Picker** — Customers browse available products and click
   to add them to their box
 * **Grid & List Layouts** — Grid layout for visual browsing or list layout for 
   detailed product info
 * **Search** — Built-in search to quickly find products within the builder
 * **Live Progress Counter** — Visual badge showing items selected (e.g., “6/12”)
   with remaining slots count
 * **Live Price Updates** — Total price updates in real-time as items are added 
   or removed
 * **Empty Box State** — Visual illustration when the box is empty, guiding customers
   to start adding items
 * **Validation Messages** — Clear feedback like “Add 6 more item(s) to fill your
   box” before the box can be added to cart
 * **Gift Message** — Optional text area with character counter (up to 500 characters)
   for personalized messages
 * **Mobile Responsive** — Fully responsive design that works on phones, tablets,
   and desktops
 * **Category Filter Tabs** — Filter products by category with clickable tabs above
   the product grid (e.g., Dark Chocolate | Milk Chocolate | Nuts)
 * **Container Query Responsive** — Automatically adapts layout when placed in narrow
   areas like sidebars or page builder columns

**Cart, Order & Email Integration**

 * **Cart Display** — Box contents clearly shown in the WooCommerce cart
 * **Order Details** — Box contents and gift message saved to the order and visible
   in the admin order screen
 * **Email Integration** — Box contents and gift message included in order confirmation
   emails
 * **Customer Account** — Box details visible in the customer’s My Account order
   history

**Admin & Settings**

 * **Dashboard** — Overview with active boxes count, total boxes sold, and revenue
   stats with recent box orders table and quick action links
 * **All Boxes** — Manage all box products from a central list
 * **Settings Page** — Six configuration tabs for full control:
    - **General** — Layout style, products per page, builder position on product
      page, summary panel position, add-to-box interaction mode, quantity controls
    - **Display** — Visual display options for the builder
    - **Labels** — Customize all text labels shown to customers
    - **Gift Message** — Enable/disable gift message, set character limits
    - **Cart** — Cart display and behavior settings
    - **Appearance** — Brand colors and visual customization

#### BoxBuilder Pro

Upgrade to [BoxBuilder Pro](https://swiftlywp.com/plugin/boxbuilder-for-woocommerce/)
for advanced features:

**Multiple Box Sizes**

 * Offer Small, Medium, Large (or any custom sizes) with individual capacities and
   prices
 * Display sizes as visual cards or a compact dropdown selector
 * Configurable size change behavior — clear items, keep items that fit, or warn
   before changing

**Custom Items**

 * Define text-based items with prices grouped by category — no WooCommerce products
   needed
 * Perfect for flavors, options, or variations that don’t need full WooCommerce 
   product listings

**Advanced Pricing**

 * Hybrid pricing — base box price plus per-item prices combined

**Enhanced Customer Experience**

 * Save box for later — logged-in customers can resume building
 * Share box via URL — shareable links to pre-filled boxes

**Analytics Dashboard**

 * Orders with boxes, boxes sold, and box revenue
 * Items in boxes, average fill rate, and average order value
 * Most popular products added to boxes
 * Top selling box products by orders and quantity
 * Insights — average items per box, average box value, boxes per order
 * Date range filtering (last 7 days, 30 days, 90 days, custom)

[Upgrade to BoxBuilder Pro ](https://swiftlywp.com/plugin/boxbuilder-for-woocommerce/)

#### Built for Performance

BoxBuilder loads scripts and styles only on pages where the builder is active — 
never sitewide. The frontend uses lightweight vanilla JavaScript with no framework
dependencies, keeping your store fast.

#### Theme & Page Builder Compatible

Tested with popular themes including Storefront, Astra, GeneratePress, Flatsome,
OceanWP, Divi, and Avada. Works with Elementor, Divi Builder, WPBakery, Bricks, 
Beaver Builder, and Oxygen via shortcode.

#### Developer Friendly

 * WordPress and WooCommerce coding standards
 * Hookable actions and filters on all major operations
 * CSS custom properties (`--bb-primary`, `--bb-border`, etc.) for easy styling
 * No custom database tables — uses standard WooCommerce data storage
 * Translation-ready with .pot file included

#### Perfect For

 * Candy & chocolate shops
 * Gift hamper and gift basket businesses
 * Flower shops and florists
 * Bakeries and patisseries
 * Corporate gift companies
 * Wine and spirits mixed cases
 * Beauty and skincare sample boxes
 * Pet treat boxes
 * Craft supply kits

#### Requirements

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

## Screenshots

 * [[
 * Frontend box builder — grid layout with product picker and summary panel
 * [[
 * Frontend box builder — list layout showing product details with add-to-box buttons
 * [[
 * Admin dashboard — active boxes, boxes sold, revenue, recent orders, and quick
   actions
 * [[
 * Settings page — six tabs for configuring layout, labels, gift message, cart, 
   and appearance
 * [[
 * Product editor — BoxBuilder metabox with capacity, pricing, and product source
   configuration
 * [[
 * Category filter tabs — filter products by category with clickable tabs above 
   the grid
 * [[
 * Cart display — box contents clearly shown in the WooCommerce cart
 * [[
 * Mobile view — fully responsive builder adapting to smaller screens

## Installation

 1. Upload the plugin files to `/wp-content/plugins/boxbuilder-for-woocommerce/` or
    install directly through the WordPress plugin screen.
 2. Activate the plugin through the **Plugins** screen in WordPress.
 3. Make sure **WooCommerce** is installed and activated.
 4. Go to **BoxBuilder** in the WordPress admin sidebar.
 5. Navigate to **All Boxes** or go to **Products  Edit** any product and enable BoxBuilder
    in the product data panel.
 6. Configure the box capacity, allowed products, and pricing model.
 7. Use the shortcode `[boxbuilder id="123"]` or the Gutenberg block to display the
    builder on any page, or let it appear automatically on the product page.

## FAQ

### Does this plugin require WooCommerce?

Yes, WooCommerce 7.0 or higher must be installed and activated.

### How do I create a box product?

Go to **Products  Edit** on any WooCommerce product, click the **BoxBuilder** tab
in the product data panel, and toggle **Enable BoxBuilder**. Configure the capacity,
pricing, and available products. You can also manage boxes from **BoxBuilder  All
Boxes** in the admin menu.

### What are Custom Items?

Custom Items (Pro) let you define text-based products with prices directly in the
box configuration — no WooCommerce products needed. This is perfect for flavors,
options, or variations. You organize them into groups (e.g., “Dark Chocolate”, “
Milk Chocolate”) and each item has a name and price.

### What pricing models are available?

The free version supports **Fixed Price** (one price for the whole box regardless
of items selected) and **Per-Item Pricing** (total is the sum of selected items).
The Pro version adds **Hybrid Pricing** (base box price plus per-item prices).

### Can I control which products appear in the builder?

Yes. The free version offers three options: **All Products** (every product in your
store), **By Category** (select specific categories), or **Specific Products** (
hand-pick individual products). The Pro version adds **Custom Items** (define your
own text-based items with prices — no WooCommerce products needed).

### Can customers add a gift message?

Yes. An optional gift message text area is shown below the product picker. It includes
a character counter (configurable limit, default 500 characters). The message is
saved with the order and shown in confirmation emails, admin order view, and customer
order history.

### Does the builder work in list and grid layouts?

Yes. You can choose between **Grid** layout (product cards in a responsive grid)
or **List** layout (products shown in rows with name, category, price, and add button).
Configure this in BoxBuilder  Settings  General.

### Where does the builder appear on the product page?

You can configure the builder position in **BoxBuilder  Settings  General  Position
on Product Page**. Options include Before Product Tabs, After Product Details Block(
for FSE/block themes), and Shortcode Only (manual placement). You can also set the
summary panel to appear on the right side or bottom.

### What happens when a product goes out of stock?

Out-of-stock products are automatically hidden from the builder so customers only
see available products.

### Can I customize the text labels?

Yes. The **Labels** tab in Settings lets you customize all user-facing text — button
labels, headings, messages, and more — without editing code.

### Is it mobile responsive?

Yes. BoxBuilder is fully responsive and also uses CSS container queries, so it automatically
adapts when placed in narrow areas like sidebars or small page builder columns.

### Does it work with my theme?

BoxBuilder works with any properly coded WooCommerce theme. It has been tested with
Storefront, Astra, GeneratePress, Flatsome, OceanWP, Divi, and Avada.

### Does it work with page builders?

Yes. Use the `[boxbuilder id="123"]` shortcode or the native Gutenberg block. The
shortcode works with Elementor, Divi Builder, WPBakery, Bricks Builder, Beaver Builder,
and Oxygen Builder.

### Can I customize colors and appearance?

Yes. The **Appearance** tab in Settings lets you set brand colors. BoxBuilder also
uses CSS custom properties (`--bb-primary`, `--bb-secondary`, `--bb-border`, etc.)
that you can override in your theme’s CSS for full control.

### Does it create custom database tables?

No. BoxBuilder uses standard WordPress and WooCommerce data storage (post meta, 
order item meta, options). This ensures full compatibility with backup plugins, 
migration tools, and the WooCommerce ecosystem.

### Where do box contents appear after purchase?

Box contents are displayed in the WooCommerce cart, checkout order review, order
confirmation emails, the customer’s My Account order history, and the admin order
detail screen.

### Is it translation ready?

Yes. All user-facing strings are translatable. A .pot file is included for use with
translation tools like Loco Translate or WPML.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“BoxBuilder for WooCommerce” is open source software. The following people have 
contributed to this plugin.

Contributors

 *   [ SwiftlyWP ](https://profiles.wordpress.org/theswiftlywp/)
 *   [ Chetan Pal ](https://profiles.wordpress.org/gotocpal/)

[Translate “BoxBuilder for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/boxbuilder-for-woocommerce)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/boxbuilder-for-woocommerce/),
check out the [SVN repository](https://plugins.svn.wordpress.org/boxbuilder-for-woocommerce/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/boxbuilder-for-woocommerce/)
by [RSS](https://plugins.trac.wordpress.org/log/boxbuilder-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.1

 * Added Revenue stat to dashboard for all users
 * Added upgrade banner on free version dashboard
 * Fixed Docs and Support button icon alignment

#### 1.0.0

 * Initial release
 * Interactive box builder with product picker
 * Grid and list layout options
 * Fixed price and per-item pricing models
 * Category filter tabs for browsing products by category
 * Gift message with character counter
 * Full WooCommerce cart, order, and email integration
 * Shortcode and Gutenberg block support
 * Admin dashboard with stats and recent orders
 * Settings page with six configuration tabs
 * Mobile responsive with CSS container queries
 * Out-of-stock product auto-hiding
 * CSS custom property support for theme customization

## Meta

 *  Version **1.0.1**
 *  Last updated **4 jou ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.0 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/boxbuilder-for-woocommerce/)
 * Tags
 * [custom box](https://hat.wordpress.org/plugins/tags/custom-box/)[gift box](https://hat.wordpress.org/plugins/tags/gift-box/)
   [mix and match](https://hat.wordpress.org/plugins/tags/mix-and-match/)[product bundle](https://hat.wordpress.org/plugins/tags/product-bundle/)
   [woocommerce](https://hat.wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://hat.wordpress.org/plugins/boxbuilder-for-woocommerce/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/boxbuilder-for-woocommerce/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/boxbuilder-for-woocommerce/reviews/)

## Contributors

 *   [ SwiftlyWP ](https://profiles.wordpress.org/theswiftlywp/)
 *   [ Chetan Pal ](https://profiles.wordpress.org/gotocpal/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/boxbuilder-for-woocommerce/)