Skip to main content
When a customer checks out with a box product, the box contents are preserved in the WooCommerce order and included in all relevant emails.

​
Order Storage

Box data is stored using standard WooCommerce order item meta:
  • Parent order item: The box product with meta _boxbuilder_is_box = yes
  • Child order items: Each selected product, linked to the parent via _boxbuilder_part_of_box
  • Gift message: Stored as _boxbuilder_message on the parent order item
This means box data is:
  • Backed up with standard WordPress/WooCommerce backups
  • Accessible to any plugin that reads order item meta
  • Preserved through order status changes

​
Admin Order Screen

When viewing an order in WooCommerce → Orders, box orders show:
  • The box product as a line item
  • Box contents listed as sub-items beneath the parent
  • Gift message displayed with the box item
  • Each child item with its product name and quantity
Click on any child item to go to its WooCommerce product page. This makes it easy to check stock or edit individual products.

​
Customer-Facing Displays

​
Order Confirmation Page (Thank You Page)

After checkout, the order confirmation page shows:
  • Box product name
  • Box contents listed
  • Gift message (if provided)

​
My Account → Orders

In the customer’s account area, past orders show box contents when the order is expanded. Customers can see exactly what was in each box.

​
Order Emails

Box contents are included in these WooCommerce emails:
EmailSent ToBox Contents Shown
New OrderAdminYes
Order ConfirmationCustomerYes
Processing OrderCustomerYes
Completed OrderCustomerYes
Refunded OrderCustomerYes
The gift message is also included in order emails.

​
Packing Slip Integration

Because box items are stored as standard WooCommerce order items, they’re automatically visible to packing slip plugins:
  • WooCommerce PDF Invoices & Packing Slips — child items appear on packing slips
  • YITH WooCommerce PDF Invoices — compatible
BoxBuilder Pro includes enhanced packing slip formatting that groups child items visually under their parent box.

​
Refunds

When refunding a box order:
  • Refunding the parent box item refunds the box price
  • Stock for individual items can be restored through standard WooCommerce refund controls
  • Partial refunds work as expected