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

# Subscription Boxes

> Recurring customizable box subscriptions with WooCommerce Subscriptions.

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

BoxBuilder Pro integrates with WooCommerce Subscriptions to offer recurring, customizable box subscriptions. Customers subscribe to a box and customize their selections before each renewal.

## Requirements

* [WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/) (official extension)
* Or [Sumo Subscriptions](https://developer.sumo.dev/)

## How It Works

<Steps>
  <Step title="Create a subscription product">
    Create a WooCommerce Subscription product with your desired billing period (monthly, quarterly, etc.).
  </Step>

  <Step title="Enable BoxBuilder">
    Enable BoxBuilder on the subscription product, configure capacity, products, and pricing.
  </Step>

  <Step title="Customer subscribes">
    Customer builds their first box and subscribes. Their box configuration is saved with the subscription.
  </Step>

  <Step title="Before each renewal">
    Before the next billing date, the customer can log in and customize their box for the upcoming period.
  </Step>

  <Step title="Lock-in deadline">
    A configurable deadline (e.g., 3 days before billing) locks the box for customization. After the deadline, the current configuration is used.
  </Step>
</Steps>

## Notification Emails

BoxBuilder sends a reminder email before each renewal period:

> "Your next box ships on \[date]. Customize your box before \[deadline]."

If the customer doesn't customize their box before the deadline, the default box contents (set by the admin or the customer's previous selection) are used.

## Admin Configuration

* Set the **customization deadline** (days before renewal)
* Set **default box contents** used when customers don't customize
* View subscription box history for each customer

## Use Cases

| Business Type  | Subscription Box                                         |
| -------------- | -------------------------------------------------------- |
| Coffee roaster | Monthly coffee selection box — choose 4 bags each month  |
| Snack company  | Quarterly snack box — pick your favorites every 3 months |
| Beauty brand   | Monthly sample box — choose products to try              |
| Book club      | Monthly book box — select genres or specific titles      |