Description
๐ฆ Build-your-own-box, done right
BoxCraft lets your customers create their own box from your WooCommerce catalogue: Pack of 6, Pack of 12, or any size you define. You decide which products are eligible and how the box is priced. Customers pick items with a fast, mobile-friendly picker, watch a live progress bar fill up, and add the finished box to the cart.
Perfect for chocolate and snack boxes, coffee and tea samplers, bakery boxes, skincare sets, wine and craft-beer packs, gift hampers, plant bundles and anything else sold in fixed quantities.
โจ Highlights
- ๐ Fixed item count: a Pack of 6 must contain exactly six items. The Add to cart button stays disabled until the box is complete.
- ๐ฐ Two pricing modes per pack size:
- Fixed pack price: for example, any six items cost $30.
- Sum of selected items: the box costs the total of the chosen products’ WooCommerce prices, sale prices included.
- ๐ฏ Flexible eligibility: choose products by search, by category (sub-categories included), exclude specific products, and set optional per-product limits.
- ๐ Repeat selections: allow several units of the same product, or restrict each product to one per box.
- ๐จ Variable products supported: the customer must choose a variation (size, flavour, colour) before it counts.
- ๐ Live progress and total: “4 of 6 items selected”, with the price updating instantly.
- ๐ Works in your cart: the box appears as one clear line with its contents listed underneath. Customers can edit it from the cart.
- ๐ Server-side validation: price, item count, variations and stock are re-checked on the server. Nothing the browser sends is trusted.
๐งฉ Everything you get
For shoppers ๐๏ธ
- Responsive product picker with grid or list layout and touch-friendly controls
- Search, category filter and sorting by name or price
- Product images, descriptions, prices and stock status (“In stock”, “Only 3 left”, “Out of stock”)
- Quantity steppers and add/remove buttons
- Live progress bar and price summary: sticky bar, side panel or above the products
- Clear messages such as “Select 2 more items to complete your box”
- Edit a box from the cart with the previous selection restored and re-validated
- Box contents visible in the cart, checkout, order confirmation, My Account and emails
For store owners ๐งโ๐ผ
- Create as many boxes as you like, each with several pack sizes
- Collapsible pack-size sections with a one-line summary, plus Expand all / Collapse all
- Pricing summary preview for every pack size
- Availability dates: start and end date for seasonal boxes
- Coupon control: allow or block coupons per box
- Tax class and shipping class per box, following your WooCommerce tax settings
- Show or hide product images, descriptions and prices in the picker
- Custom button label, accent colour, error messages and layout settings
- Basic reports: orders by pack size, by pricing mode, and your most-selected products
Inventory ๐ฆ
- Stock is validated whenever a box is added, edited, or its quantity changes
- Component stock is reduced when an order is placed, restored on cancellation, and restocked on refunds when “Restock refunded items” is ticked
- Hide out-of-stock products or show them as unavailable. Out-of-stock items can never be added to a box.
- Works for fixed-price boxes too: the selected products’ stock is still tracked
Placement ๐
- Automatic product page for every box
- Show a box on other product pages, on chosen category pages or on the shop page
[byob_box id="123"]shortcode- “BoxCraft box” Gutenberg block
Built to be trusted ๐ก๏ธ
- HPOS (High-Performance Order Storage) compatible
- Works with the classic and block-based Cart and Checkout
- Accessible: keyboard navigation, screen-reader announcements, text labels (not colour alone)
- Translation-ready, and follows your site’s language, currency and decimal settings
- Capability checks and nonces on admin actions; sanitised, escaped and prepared throughout
- Uninstalling never deletes WooCommerce orders
๐ Want more? BoxCraft Pro
Go beyond a single fixed-count box with BoxCraft Pro:
- ๐ช Multi-step boxes: “Choose 2 snacks, 2 drinks, 2 extras”
- ๐ Selection rules: minimums, maximums, required and incompatible items
- ๐ Advanced pricing: tiers, surcharges, discounts, paid add-ons and free gifts
- ๐งฌ Templates, duplicate boxes and JSON export / import
- ๐ Gift messages, personalisation, saved and shared boxes
- ๐ Richer reports with CSV export
How it works
Each box owns a hidden WooCommerce product (the “box product”). The cart and order line is that product with a name like “Snack Box โ Pack of 6”. The selected items are stored on the line and re-validated on the server whenever the cart changes and again at checkout. The price is always calculated on the server, and nothing sent by the browser is trusted. Do not delete the box product: cart and order lines use it.
Deactivation and uninstall
- Deactivating the plugin keeps all boxes, settings and orders. Existing orders keep their box contents as order item meta, so they stay readable.
- Disabling a box (untick “Enabled”, change it to draft, or trash it) hides it on the storefront and makes its box product private. Existing orders are unaffected; carts that still contain it are asked to remove it.
- Deleting the plugin never deletes WooCommerce orders or their box data. Box configurations and settings are removed only if “Delete box configurations when the plugin is deleted” is ticked in Settings. Box products are always kept because past orders refer to them.
Known limitations
- Fixed-amount (whole cart) coupons cannot be blocked for a single line item by WooCommerce. “Allow coupons: off” stops WooCommerce applying coupons to the box line (percentage and fixed-product discounts, and the box’s share of fixed-cart discounts).
- The “Edit box” link in the Cart block is shown as a link only in themes and versions that allow HTML in item data. The classic cart and the cart notices always show a clickable link.
- Block themes do not run classic product hooks. The box is injected in place of the Add to Cart block on its own product page, and other placements need the block or shortcode.
- All pack sizes of one box share the tax class and shipping class set on the box.
Screenshots









Blocks
This plugin provides 1 block.
- BoxCraft box Let customers fill a box with a fixed number of products.
Installation
- Install and activate WooCommerce.
- Upload the
boxcraft-for-woocommercefolder to/wp-content/plugins/, or install it from Plugins Add New. - Activate BoxCraft for WooCommerce through the Plugins screen.
- Open the BoxCraft menu (below Products) and click Add box.
- Give the box a name (shown in the cart as “Name โ Pack of 6”), then add a description and featured image.
- On the Pack sizes & pricing tab add your sizes (for example 6 and 12), choose the pricing mode and pick the eligible products or categories.
- Click Publish. The box gets its own product page automatically. Use the shortcode or block to show it anywhere else.
- Visit BoxCraft Settings to adjust labels, messages, accent colour, emails and reports.
FAQ
-
๐ค How does a customer build a box?
-
They choose a pack size, pick products in the picker until the progress bar is full (for example “6 of 6 items selected”), then click Add box to cart. The button stays disabled until the box is complete.
-
๐ฒ What is the difference between the two pricing modes?
-
With Fixed pack price the customer always pays the price you set (for example $30 for six items), whatever they choose. With Sum of selected items the price is the total of the chosen products’ current WooCommerce prices, sale prices included. You can choose a different mode for each pack size.
-
๐ Can a customer pick the same product more than once?
-
Yes, if you leave Allow repeat selections on (the default). They can add several units, up to the product’s available stock. Turn it off to allow each product or variation only once per box.
-
๐จ How do variable products work?
-
The customer must choose a variation (for example flavour or size) before the item counts toward the box. The variation’s own price and stock are used.
-
๐ฆ Is stock reduced for the products inside the box?
-
Yes. When the order is placed the stock of every selected product or variation is reduced, using WooCommerce’s normal stock rules. It is restored if the order is cancelled, and restocked on refunds when you tick “Restock refunded items”. This also applies to fixed-price boxes. You can switch it off per box in the Inventory tab.
-
๐ซ What happens if a product sells out or is unpublished while it is in someone’s cart?
-
Nothing is silently charged. The cart and checkout re-validate every box. If something is no longer available the customer sees a clear message with an Edit your box link and must pick a replacement before checking out.
-
๐ Can customers cheat the price by editing the page?
-
No. The price, item count, variations and stock are all calculated and checked on the server. The browser’s numbers are only for display.
-
๐งพ Where do customers and I see the box contents?
-
In the cart, checkout, order confirmation page, My Account, the admin order screen and, if you leave Include box contents in order emails on, in order emails.
-
๐๏ธ Can I stop coupons applying to boxes?
-
Yes. Untick Allow coupons in the box’s General tab.
-
๐งฎ How are tax and shipping handled?
-
Totals follow your WooCommerce tax and currency settings. Choose a tax class and a shipping class for each box in the General tab. The box ships as a single item.
-
๐ Where can I show a box?
-
On its own automatically created product page, on other product pages, on category pages or the shop page (set in the Placement tab), or anywhere with the
[byob_box id="123"]shortcode or the BoxCraft box block. In block themes, add the block or shortcode to the template or page where you want it. -
โฐ Can I run a box only for a limited time?
-
Yes. Set optional start and end dates in the General tab. Outside those dates the box is hidden.
-
๐ What happens if I disable or delete a box?
-
Disabling a box hides it on the storefront and makes its product private. Existing orders are not affected and keep their contents. Please do not delete the hidden box product, because cart and order lines use it.
-
๐งน What happens if I deactivate or delete the plugin?
-
Deactivating keeps everything. Deleting the plugin never deletes WooCommerce orders or their box data. Box configurations and settings are removed only if you tick Delete box configurations when the plugin is deleted in Settings.
-
๐งฑ Does it work with block themes and the block Cart and Checkout?
-
Yes. BoxCraft supports the classic and block-based Cart and Checkout, and is compatible with HPOS.
-
โฟ Is it accessible?
-
The picker supports keyboard navigation, labelled controls, screen-reader progress announcements, and text labels instead of relying on colour alone.
-
๐ Can I translate it?
-
Yes. All strings are translation-ready and use the
boxcraft-for-woocommercetext domain. -
๐ What does BoxCraft Pro add?
-
Multi-step boxes, selection rules, advanced pricing and discounts, templates, gift messages and personalisation, saved and shared boxes, and richer reports. See BoxCraft Pro.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“BoxCraft for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “BoxCraft for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- ๐ Initial release: pack sizes, fixed and sum pricing, product picker, cart editing, stock handling, shortcode, block and reports.
