> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swiftlywp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Orders & Emails

> How box contents are stored in orders and displayed in emails.

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

<Tip>
  Click on any child item to go to its WooCommerce product page. This makes it easy to check stock or edit individual products.
</Tip>

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

| Email                  | Sent To  | Box Contents Shown |
| ---------------------- | -------- | ------------------ |
| **New Order**          | Admin    | Yes                |
| **Order Confirmation** | Customer | Yes                |
| **Processing Order**   | Customer | Yes                |
| **Completed Order**    | Customer | Yes                |
| **Refunded Order**     | Customer | Yes                |

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

<Info>
  BoxBuilder Pro includes enhanced packing slip formatting that groups child items visually under their parent box.
</Info>

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

## Related

* [Cart Integration](/plugins/boxbuilder/cart-integration) — how boxes work in the cart
* [Inventory](/plugins/boxbuilder/inventory) — stock management for box items