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

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

Changelog

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