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

# Quickstart

> Create your first box product in 5 minutes.

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](https://docs.swiftlywp.com/plugins/boxbuilder/installation.md))
* 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.

> [!TIP]
>
> 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 products per page (default: 12).

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

> [!TIP]
>
> You've created and tested your first box product. Next, explore [pricing models](https://docs.swiftlywp.com/plugins/boxbuilder/pricing-models.md), [display settings](https://docs.swiftlywp.com/plugins/boxbuilder/layouts.md), or the full [settings reference](https://docs.swiftlywp.com/plugins/boxbuilder/settings.md).

## Next Steps

> [card] [Pricing Models](https://docs.swiftlywp.com/plugins/boxbuilder/pricing-models.md)
>
> Fixed price, per-item, or hybrid pricing.

> [card] [Layouts & Display](https://docs.swiftlywp.com/plugins/boxbuilder/layouts.md)
>
> Grid, list, summary panel, and mobile options.

> [card] [Settings](https://docs.swiftlywp.com/plugins/boxbuilder/settings.md)
>
> Full reference of all 6 settings tabs.

> [card] [Gift Messages](https://docs.swiftlywp.com/plugins/boxbuilder/gift-messages.md)
>
> Enable and customize gift messages.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.