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

<Tabs>
  <Tab title="From WordPress Admin">
    <Steps>
      <Step title="Go to Plugins → Add New">
        In your WordPress admin, navigate to **Plugins → Add New**.
      </Step>

      <Step title="Search for BoxBuilder">
        Type **"BoxBuilder for WooCommerce"** in the search box.
      </Step>

      <Step title="Install and Activate">
        Click **Install Now**, then click **Activate**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Manual Upload">
    <Steps>
      <Step title="Download the ZIP">
        Download `boxbuilder-for-woocommerce.zip` from [WordPress.org](https://wordpress.org/plugins/boxbuilder-for-woocommerce/).
      </Step>

      <Step title="Upload via WordPress">
        Go to **Plugins → Add New → Upload Plugin**. Choose the ZIP file and click **Install Now**.
      </Step>

      <Step title="Activate">
        Click **Activate Plugin**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Installing BoxBuilder Pro

<Steps>
  <Step title="Purchase a license">
    Get your Pro license at [swiftlywp.com/plugin/boxbuilder-for-woocommerce](https://swiftlywp.com/plugin/boxbuilder-for-woocommerce/).
  </Step>

  <Step title="Download the Pro ZIP">
    After purchase, download `boxbuilder-pro.zip` from your [SwiftlyWP account](https://app.swiftlywp.com).
  </Step>

  <Step title="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.
  </Step>

  <Step title="Activate your license">
    Go to **BoxBuilder → License** and enter your license key. Click **Activate**.
  </Step>
</Steps>

<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.
</Note>

## 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**.
</Tip>

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

## 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](/plugins/boxbuilder/quickstart) to create your first box.