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

# FAQ

> Frequently asked questions about BoxBuilder for WooCommerce.

## General

> [accordion] Does BoxBuilder work with any WooCommerce theme?
>
> Yes. BoxBuilder is designed to work with any well-coded WordPress theme. It's tested with Storefront, Astra, GeneratePress, Flatsome, OceanWP, Divi, and Avada. All styles are namespaced under `.boxbuilder-wrap` to prevent conflicts.

> [accordion] Can I create multiple box products?
>
> Yes. You can create as many box products as you want, each with its own configuration — different capacities, product sources, pricing models, and layouts. There's no limit in either the Free or Pro version.

> [accordion] Does BoxBuilder create custom database tables?
>
> No. BoxBuilder stores all data using standard WordPress and WooCommerce storage (post meta, order item meta, user meta, wp\_options). This ensures full compatibility with backup plugins, migration tools, and the WooCommerce ecosystem.

> [accordion] Can I use the same product in multiple boxes?
>
> Yes. A product can be included in as many different box configurations as you want. Stock is shared — if a product has 10 units, those 10 units are available across all boxes.

> [accordion] Does BoxBuilder work with WooCommerce Blocks?
>
> Yes. BoxBuilder is compatible with the WooCommerce block-based cart and checkout. It also includes a native Gutenberg block for embedding the builder in pages.

## Pricing & Stock

> [accordion] How does stock work for items inside a box?
>
> Each item in the box is added to the WooCommerce cart as a hidden sub-item. WooCommerce handles stock reduction for each individual product at checkout. If a product goes out of stock, it's automatically hidden from the builder.

> [accordion] Can I offer a discount when the box is full?
>
> In the free version, you can achieve this with fixed pricing — set a box price that's less than the total of individual items. BoxBuilder Pro adds quantity-based discounts and bundle discount features.

> [accordion] Do coupons work with box products?
>
> Yes. Standard WooCommerce coupons work with box products. For fixed-price boxes, the coupon applies to the box price. For per-item boxes, coupons can apply to individual item prices.

> [accordion] Does BoxBuilder work with WooCommerce tax settings?
>
> Yes. BoxBuilder uses standard WooCommerce pricing and cart calculations, so your existing tax configuration applies automatically.

## Features

> [accordion] Can customers add a gift message?
>
> Yes. Gift messages are built into the free version. Enable them in **BoxBuilder → Settings → Gift Message**. The message is saved with the order and included in order emails.

> [accordion] Can I use BoxBuilder on a page other than the product page?
>
> Yes. Use the `[boxbuilder id="123"]` shortcode or the Gutenberg block to place the builder on any page or post.

> [accordion] Can customers add multiple units of the same item?
>
> Yes. The builder includes quantity controls (+/-) so customers can add multiple units of the same product to their box, up to the box capacity.

> [accordion] What happens when a customer removes a box from the cart?
>
> All hidden sub-items (the individual products in the box) are automatically removed along with the parent box item. There's no way for orphaned items to remain.

> [accordion] Can I offer partially filled boxes?
>
> Yes. Enable **Allow Partial** in the box configuration. Customers can add the box to cart with fewer items than the maximum capacity. You can also set a minimum with range-based capacity.

## Pro

> [accordion] What's the difference between Free and Pro?
>
> The free version includes everything needed to run a box-building experience: box products, fixed/per-item pricing, layouts, gift messages, and full WooCommerce integration. Pro adds multiple box sizes, category filters, custom items, hybrid pricing, analytics, saved boxes, shareable URLs, subscription mode, and multi-currency support. See the [full comparison](https://docs.swiftlywp.com/plugins/boxbuilder/pro-overview.md).

> [accordion] Can I upgrade from Free to Pro without losing data?
>
> Yes. All your box configurations, settings, and order data are preserved when upgrading. Simply deactivate the free version, install Pro, and activate your license.

> [accordion] Do I need the Pro version for a basic gift box store?
>
> No. The free version is fully functional for a store that needs basic box-building with fixed or per-item pricing. Many stores run successfully on the free version.

> [accordion] Can I run both Free and Pro at the same time?
>
> No. BoxBuilder detects if both versions are installed and only loads one. You should deactivate and delete the version you're not using.

## Technical

> [accordion] What are the minimum requirements?
>
> WordPress 6.0+, WooCommerce 7.0+, and PHP 7.4+. We recommend the latest versions of WordPress and WooCommerce with PHP 8.1+.

> [accordion] Is BoxBuilder translation-ready?
>
> Yes. All strings use the `boxbuilder-wc` text domain. A `.pot` file is included for translations. BoxBuilder Pro also supports WPML for full multilingual support.

> [accordion] Can I customize the builder HTML?
>
> BoxBuilder Pro includes a template override system. Copy templates from the plugin's `/templates/` directory to your theme's `boxbuilder/` folder to customize the HTML. See [Template Overrides](https://docs.swiftlywp.com/plugins/boxbuilder/template-overrides.md).

> [accordion] Does BoxBuilder have an API?
>
> BoxBuilder Pro includes REST API endpoints under the `boxbuilder/v1` namespace. See [REST API](https://docs.swiftlywp.com/plugins/boxbuilder/rest-api.md).


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