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

# Compatibility

> Themes, page builders, and plugins tested with BoxBuilder.

BoxBuilder is tested with the most popular WordPress themes, page builders, and WooCommerce extensions.

## Themes

BoxBuilder is tested and confirmed compatible with:

| Theme                            | Status           |
| -------------------------------- | ---------------- |
| Storefront (WooCommerce default) | Fully compatible |
| Astra                            | Fully compatible |
| GeneratePress                    | Fully compatible |
| Flatsome                         | Fully compatible |
| OceanWP                          | Fully compatible |
| Divi (as theme)                  | Fully compatible |
| Avada                            | Fully compatible |

BoxBuilder is designed to work with any well-coded WordPress theme. If you experience issues with a specific theme, [contact support](https://swiftlywp.com/support/).

## Page Builders

The `[boxbuilder id="123"]` shortcode and Gutenberg block work with all major page builders:

| Page Builder             | Integration              |
| ------------------------ | ------------------------ |
| Gutenberg / Block Editor | Native block + shortcode |
| Elementor                | Shortcode widget         |
| Divi Builder             | Code module or shortcode |
| WPBakery                 | Text block or raw HTML   |
| Bricks Builder           | Shortcode element        |
| Beaver Builder           | HTML module              |
| Oxygen Builder           | Shortcode component      |

## WooCommerce Extensions

| Extension                       | Status           | Notes                               |
| ------------------------------- | ---------------- | ----------------------------------- |
| WooCommerce Subscriptions       | Compatible (Pro) | Required for subscription box mode  |
| YITH WooCommerce PDF Invoices   | Compatible       | Box contents shown on invoices      |
| WC PDF Invoices & Packing Slips | Compatible       | Box contents shown on packing slips |
| WPML + WooCommerce Multilingual | Compatible (Pro) | Full translation support            |
| WooCommerce Bookings            | Compatible       | No conflicts                        |
| WooCommerce Points and Rewards  | Compatible       | Points earned on box purchases      |
| Sumo Subscriptions              | Compatible (Pro) | Alternative subscription plugin     |
| Fox Currency Switcher           | Compatible (Pro) | Multi-currency pricing              |

## Checkout Plugins

| Plugin                 | Status     |
| ---------------------- | ---------- |
| CheckoutWC             | Compatible |
| FunnelKit / WooFunnels | Compatible |
| CartFlows              | Compatible |

## WooCommerce Cart/Checkout Blocks

BoxBuilder is compatible with the WooCommerce block-based cart and checkout. Child items are filtered from the Store API so they don't appear as separate line items.

## Known Interactions

<AccordionGroup>
  <Accordion title="WooCommerce lightbox on box product pages">
    BoxBuilder automatically disables the WooCommerce product image lightbox on box product pages to prevent conflicts with the builder UI. This is intentional.
  </Accordion>

  <Accordion title="Caching plugins">
    If you use a caching plugin (WP Rocket, W3 Total Cache, LiteSpeed Cache), make sure your cart pages and box product pages are excluded from page caching. AJAX requests should not be cached.
  </Accordion>

  <Accordion title="Minification plugins">
    CSS/JS minification plugins (Autoptimize, WP Rocket) should work fine. If you experience issues, try excluding BoxBuilder's CSS and JS files from minification.
  </Accordion>
</AccordionGroup>

## Reporting Compatibility Issues

If you find a plugin or theme that doesn't work with BoxBuilder:

1. Deactivate other plugins one by one to identify the conflict
2. Try switching to the Storefront theme to rule out theme issues
3. [Contact support](https://swiftlywp.com/support/) with:
   * WordPress version
   * WooCommerce version
   * BoxBuilder version
   * Conflicting plugin/theme name and version
   * Description of the issue
   * Screenshots if possible