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

<AccordionGroup>
  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

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

## Pricing & Stock

<AccordionGroup>
  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="Does BoxBuilder work with WooCommerce tax settings?">
    Yes. BoxBuilder uses standard WooCommerce pricing and cart calculations, so your existing tax configuration applies automatically.
  </Accordion>
</AccordionGroup>

## Features

<AccordionGroup>
  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

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

## Pro

<AccordionGroup>
  <Accordion title="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](/plugins/boxbuilder/pro-overview).
  </Accordion>

  <Accordion title="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>

  <Accordion title="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>

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

## Technical

<AccordionGroup>
  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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](/plugins/boxbuilder/template-overrides).
  </Accordion>

  <Accordion title="Does BoxBuilder have an API?">
    BoxBuilder Pro includes REST API endpoints under the `boxbuilder/v1` namespace. See [REST API](/plugins/boxbuilder/rest-api).
  </Accordion>
</AccordionGroup>