Skip to main content
This guide walks you through creating a box product, configuring it, and seeing it live on your store.

​
Before You Start

Make sure you have:
  • BoxBuilder installed and activated (Installation guide)
  • WooCommerce installed with at least a few products in your store
  • Products with prices and images set up

​
Create Your First Box

1

Create a new WooCommerce product

Go to Products → Add New in your WordPress admin. Give your product a name (e.g., “Build Your Own Gift Box”), set a price, and add a featured image.
For fixed pricing, the product price is the box price regardless of items selected. For per-item pricing, set the product price to 0 — the total will be calculated from the items the customer picks.
2

Enable BoxBuilder

In the Product Data panel, click the BoxBuilder tab. Check the Enable BoxBuilder checkbox.
3

Set the capacity

Choose your capacity type:
  • Fixed: Exact number of items (e.g., 12)
  • Range: Minimum and maximum (e.g., 6 to 12 items)
Toggle Allow partial boxes if customers can check out without filling the box completely.
4

Choose a pricing model

  • Fixed Price: The product price applies regardless of which items are selected
  • Per-Item: Price is the sum of all selected items
5

Select available products

Choose which products customers can add to this box:
  • All Products: Every published product in your store
  • By Category: Products from specific categories (e.g., “Chocolates”, “Sweets”)
  • Specific Products: Hand-pick individual products
6

Choose a layout

Select Grid or List for the product picker display. Set the number of columns (2–6) for grid layout.
7

Publish

Click Publish. Your box product is now live.

​
View Your Box

Visit the product page on your store’s frontend. You’ll see the BoxBuilder interface with:
  • A product grid showing available items with images, names, and prices
  • An Add to Box button on each product card
  • A box summary panel showing selected items and the running total
  • A progress counter showing how many items have been added (e.g., “3 of 12”)
  • An Add to Cart button that becomes active once the box meets the minimum capacity

​
Test the Full Flow

1

Add items to the box

Click Add to Box on several products. Watch the summary panel update with each item, and the progress counter increment.
2

Fill the box

Keep adding items until you reach the capacity. The progress indicator will show the box is complete.
3

Add a gift message (optional)

If gift messages are enabled in settings, type a message in the gift message field.
4

Add to cart

Click Add to Cart. You’ll be taken to the cart page (or stay on the page, depending on your settings).
5

Check the cart

In the cart, you’ll see your box as a single line item. The box contents are shown beneath it.
6

Complete checkout

Proceed through checkout. After placing the order, check:
  • The order confirmation page shows box contents
  • The order confirmation email includes box contents
  • The admin order screen (WooCommerce → Orders) shows the box with all items
You’ve created and tested your first box product. Next, explore pricing models, display settings, or the full settings reference.

​
Next Steps

Pricing Models

Fixed price, per-item, or hybrid pricing.

Layouts & Display

Grid, list, columns, and image options.

Settings

Full reference of all 6 settings tabs.

Gift Messages

Enable and customize gift messages.