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

# Installation

> Install BoxBuilder for WooCommerce on your WordPress site.

## Installing the Free Version

> [tab] From WordPress Admin
>
> **1. Go to Plugins → Add New**
>
> In your WordPress admin, navigate to **Plugins → Add New**.
>
> **2. Search for BoxBuilder**
>
> Type **"BoxBuilder for WooCommerce"** in the search box.
>
> **3. Install and Activate**
>
> Click **Install Now**, then click **Activate**.

> [tab] Manual Upload
>
> **1. Download the ZIP**
>
> Download `boxbuilder-for-woocommerce.zip` from [WordPress.org](https://wordpress.org/plugins/boxbuilder-for-woocommerce/).
>
> **2. Upload via WordPress**
>
> Go to **Plugins → Add New → Upload Plugin**. Choose the ZIP file and click **Install Now**.
>
> **3. Activate**
>
> Click **Activate Plugin**.

## Installing BoxBuilder Pro

**1. Purchase a license**

Get your Pro license at [swiftlywp.com/plugin/boxbuilder-for-woocommerce](https://swiftlywp.com/plugin/boxbuilder-for-woocommerce/).

**2. Download the Pro ZIP**

After purchase, download `boxbuilder-pro.zip` from your [SwiftlyWP account](https://app.swiftlywp.com).

**3. Upload and activate**

Go to **Plugins → Add New → Upload Plugin**. Choose the Pro ZIP file, click **Install Now**, then **Activate**. If the free version is installed, BoxBuilder will automatically deactivate it — no manual step needed.

**4. Activate your license**

Go to **BoxBuilder → License** and enter your license key. Click **Activate**.

> [!NOTE]
>
> BoxBuilder automatically prevents both versions from running at the same time. When you activate Pro, the free version is deactivated automatically. You can safely delete the free version afterward.

## Upgrading from Free to Pro

When you upgrade from Free to Pro:

* All your box configurations are preserved
* All settings are kept
* Order history with box data remains intact
* No data is lost during the switch

Simply install and activate Pro — the free version is deactivated automatically. Then enter your license key at **BoxBuilder → License**.

## Updating BoxBuilder

### Free Version

Updates are delivered automatically through WordPress.org. You'll see update notifications in **Dashboard → Updates** and on the **Plugins** page.

### Pro Version

Pro updates are delivered through your license. When a new version is available:

1. You'll see an update notification on the **Plugins** page
2. Click **Update Now** to install the latest version
3. Your license must be active to receive updates

> [!TIP]
>
> Keep your license active to receive updates and priority support. You can manage your license at **BoxBuilder → License**.

## Requirements

| Requirement | Minimum | Recommended |
| - | - | - |
| WordPress | 6.0+ | Latest |
| WooCommerce | 7.0+ | Latest |
| PHP | 7.4+ | 8.1+ |

> [!NOTE]
>
> BoxBuilder will automatically deactivate if WooCommerce is not installed. You'll see an admin notice with a direct link to install or activate WooCommerce.

## After Installation

Once BoxBuilder is activated, you'll see a new **BoxBuilder** menu in your WordPress admin sidebar (right below WooCommerce). Head to the [Quickstart guide](https://docs.swiftlywp.com/plugins/boxbuilder/quickstart.md) to create your first box.


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