Skip to main content
A box product is a standard WooCommerce Simple Product with BoxBuilder enabled. This means it works with all existing WooCommerce features — shipping, taxes, coupons, and more.

​
Create the Product

1

Add a new product

Go to Products → Add New in your WordPress admin.
2

Set product details

Fill in the standard WooCommerce fields:
  • Product name: e.g., “Build Your Own Chocolate Box”
  • Description: Describe the box experience for your customers
  • Short description: A brief summary shown on the product page
  • Product image: The main box image customers will see
  • Product gallery: Additional images of the box or example configurations
3

Set the price

In the General tab of the Product Data panel:
  • For Fixed pricing: Set the price you want to charge for the box (e.g., $29.99)
  • For Per-item pricing: Set the price to 0 — the total will be calculated from the selected items
4

Enable BoxBuilder

Click the BoxBuilder tab in the Product Data panel. Check Enable BoxBuilder.

​
Configure the Box

Once BoxBuilder is enabled, you’ll see the configuration options:

​
Capacity

SettingDescription
Capacity TypeFixed — exact number of items. Range — minimum and maximum.
Max ItemsMaximum number of items the box can hold (e.g., 12)
Min ItemsMinimum items required (only shown for Range type)
Allow PartialIf enabled, customers can add the box to cart without filling it completely
Use Range capacity when you want flexibility. For example, a box that holds 6–12 items lets customers choose how full they want their box.

​
Pricing Model

ModelHow It WorksBest For
Fixed PriceOne price for the whole box, regardless of itemsGift boxes with a set price point
Per-ItemTotal = sum of each item’s priceBuild-your-own where items have different values
Hybrid pricing (base price + per-item) is available in BoxBuilder Pro.

​
Product Source

Choose which products customers can pick from:
SourceDescription
All ProductsEvery published, in-stock WooCommerce product
By CategoryOnly products from selected categories
Specific ProductsHand-picked individual products
Using By Category is the most common approach. Create categories like “Chocolates”, “Sweets”, “Nuts” and assign your products to them. Then select those categories as the product source for your box.

​
Layout

OptionDescription
Layout StyleGrid (card-based) or List (compact rows)
Products Per PageNumber of products to show before pagination (default: 12)

​
Gift Message

Gift messages are controlled globally in BoxBuilder → Settings → Gift Message tab. When enabled, a text field appears in the box builder for customers to type a personal message.

​
Box Overview in Admin

After creating box products, you can manage them from BoxBuilder → All Boxes. This page shows:
  • All products with BoxBuilder enabled
  • Capacity and pricing model for each box
  • Quick links to edit or view each box

​
Example Configurations

  • Capacity: Fixed, 12 items
  • Pricing: Fixed Price
  • Product price: $29.99
  • Product source: Category “Chocolates”
  • Layout: Grid
  • Gift message: Enabled
  • Capacity: Range, 6–12 items
  • Pricing: Per-Item
  • Product price: $0.00
  • Product source: Categories “Chips”, “Cookies”, “Drinks”
  • Layout: Grid
  • Allow partial: Yes
  • Capacity: Fixed, 8 items
  • Pricing: Fixed Price
  • Product price: $49.99
  • Product source: Specific products (hand-picked flowers)
  • Layout: Grid
  • Gift message: Enabled

​
Next Steps