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

# Box Sizes

> Offer multiple box sizes with different capacities and prices.

<Info>
  Multiple box sizes is a **Pro feature**. [Upgrade to BoxBuilder Pro →](https://swiftlywp.com/plugin/boxbuilder-for-woocommerce/)
</Info>

BoxBuilder Pro lets you offer multiple sizes for a single box product — for example, Small (6 items, $19.99), Medium (12 items, $34.99), and Large (24 items, \$59.99). The customer picks their size before building the box.

## Setting Up Sizes

<Steps>
  <Step title="Enable BoxBuilder on a product">
    Edit your box product and go to the **BoxBuilder** tab.
  </Step>

  <Step title="Add sizes">
    In the **Box Sizes** section, add your sizes. Each size has:

    * **Label**: The name customers see (e.g., "Small", "Medium", "Large")
    * **Capacity**: How many items this size holds
    * **Price**: The price for this size (used with fixed or hybrid pricing)
  </Step>
</Steps>

## Size Display Settings

Configure size display in **BoxBuilder → Settings → Cart** under **Box Sizes**:

### Size Display Style

| Style                          | Description                                                                                                     |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------- |
| **Cards (dropdown on mobile)** | Visual cards showing label, capacity, and price — automatically switches to dropdown on small screens (default) |
| **Dropdown selector**          | A compact dropdown menu — useful when you have many size options                                                |

You can also set the **Cards Per Row** (2, 3, 4, or 5 — default is 3) to control how many size cards appear in a row.

### Size Change Behavior

When a customer changes their size after already adding items to the box, you can control what happens:

| Behavior                               | Description                                                                        |
| -------------------------------------- | ---------------------------------------------------------------------------------- |
| **Keep items that fit, remove excess** | Items that still fit the new capacity are kept; excess items are removed (default) |
| **Prevent size change**                | Block size changes when items exceed the new capacity                              |
| **Show warning and ask to confirm**    | Display a confirmation dialog before changing                                      |

## Example Configuration

| Size      | Capacity | Price   |
| --------- | -------- | ------- |
| Small     | 6 items  | \$19.99 |
| Medium    | 12 items | \$34.99 |
| Large     | 24 items | \$59.99 |
| Party Box | 48 items | \$99.99 |

<Tip>
  Use sizes to create natural upsell opportunities. Show the per-item savings for larger sizes — "Small: $3.33/item vs Large: $2.50/item".
</Tip>

## How Sizes Work with Pricing

| Pricing Model | Size Price Behavior                          |
| ------------- | -------------------------------------------- |
| **Fixed**     | Each size has its own fixed price            |
| **Per-Item**  | Size has no price — total is sum of items    |
| **Hybrid**    | Each size has a base price + per-item prices |