The cart and checkout blocks are available for testing in the WooCommerce Blocks plugin (v2.6 and newer). These blocks are part of a ground-up rebuild of the purchase flow, based on industry best practices.
The cart and checkout blocks are fully functional, with some limitations. The blocks are not yet a complete replacement for the existing shortcodes.
The purpose of this document is to provide clear information about what is supported and what’s still in development, so stores can make an informed decision about how to use the blocks.
Requirements ↑ Back to top
To use the cart and checkout blocks, your site must meet the following requirements:
- WooCommerce Blocks plugin installed and active (v2.6 minimum, latest recommended).
- Use one or more supported payment gateways (see below for details).
Using the Cart & Checkout blocks ↑ Back to top
If you’d like to test these blocks, or use them on your own store you can follow this guide to replacing the Cart and Checkout shortcodes.
Compatible extensions ↑ Back to top
The following list of extensions are known to be compatible with the Cart & Checkout blocks. The list is continously updated as we add more integration points and extensions integrate with the blocks.
Payment Gateways ↑ Back to top
| Payment Method | Extension | Minimum Version |
|---|---|---|
| Bank Transfer (BACS) | n/a (included in WooCommerce Core) | WooCommerce Blocks v3.0+ WordPress 5.2+ |
| Cash on Delivery | n/a (included in WooCommerce Core) | WooCommerce Blocks v3.0+ WordPress 5.2+ |
| Cheque | n/a (included in WooCommerce Core) | WooCommerce Blocks v3.0+ WordPress 5.2+ |
| WooCommerce Payments | Available in WooCommerce or via the extension | WooCommerce Blocks v3.0+ WooCommerce Payments 1.6.0+ |
| PayPal Standard | n/a (included in WooCommerce Core prior to version 5.5.0, hidden in new installs since version 5.5.0) | WooCommerce Blocks v2.6+ WordPress 5.2+ |
| Stripe – Credit Card | Stripe | WooCommerce Blocks v2.6+ Stripe 4.5.1+ |
| Stripe – Payment Request (Apple Pay, Chrome Pay) | Stripe | WooCommerce Blocks v2.6+ Stripe 4.5.1+ |
| Square – Credit Card | Square | WooCommerce Blocks V3.0+ Square 2.5.0+ |
| Opayo – Credit Card | Opayo | WooCommerce Blocks v3.0+ Opayo 4.10.1+ |
| PayFast | PayFast Payment Gateway | WooCommerce Blocks v3.0+ PayFast Payment Gateway 1.4.19+ |
| eWAY | eWAY | WooCommerce Blocks v3.0+ eWAY 3.2.0+ |
Compatible Shipping methods and options ↑ Back to top
| Shipping Method | Minimum Version |
|---|---|
| WooCommerce Shipping and Tax | WooCommerce Blocks v3.0+ WordPress 5.2+ WooCommerce Shipping & Tax 1.25.9 |
| UPS | WooCommerce Blocks v3.0+ WordPress 5.2+ UPS 3.2.30+ |
| USPS | WooCommerce Blocks v3.0+ WordPress 5.2+ USPS 4.4.49+ |
| Canada Post | WooCommerce Blocks v3.0+ WordPress 5.2+ Canada Post 2.5.19+ |
| Royal Mail | WooCommerce Blocks v3.0+ WordPress 5.2+ Royal Mail 2.5.32+ |
| Australia Post | WooCommerce Blocks v3.0+ WordPress 5.2+ Australia Post 2.4.28+ |
| Table Rate Shipping | WooCommerce Blocks v3.0+ WordPress 5.2+ Table Rate Shipping 3.0.30+ |
Other compatible extensions ↑ Back to top
| Extension name | Minimum Version |
|---|---|
| Facebook for WooCommerce | WooCommerce Blocks v3.0+ WordPress 5.2+ Facebook for WooCommerce 2.2.0+ |
| Product Add-Ons | WooCommerce Blocks v4.5+ WordPress 5.4+ Product Add-Ons 3.4+ |
| WooCommerce Google Analytics Only gTag (with a G- prefixed site ID) is supported. | WooCommerce Blocks v4.9+ WordPress 5.5+ WooCommerce Google Analytics 1.5+ |
| Name Your Price | WooCommerce Blocks v4.9+ WordPress 5.5+ Name Your Price 3.2.3+ |
| Quickbooks Sync for WooCommerce | WooCommerce Blocks v4.9+ WordPress 5.5+ Quickbooks Sync for WooCommerce 2.2.1+ |
| Gravity Forms Product Add-ons | WooCommerce Blocks v4.9+ WordPress 5.5+ Gravity Forms Product Add-ons 3.3.18+ |
| WooCommerce Subscriptions | WooCommerce Blocks v4.9+ WordPress 5.5+ WooCommerce Subscriptions 3.1.0+ |
Known incompatible extensions ↑ Back to top
The following are a list of extensions that are known to not be currently compatible with the Cart & Checkout blocks. If you are using one of these extensions on your store, we’d advise you keep using the shortcode based checkout for now. We are actively working on adding the extensibility points needed by extensions. As these extensions are integrated – we’ll update this list.
- Amazon Pay
- AutomateWoo
- Bookings
- Box Office
- Cart Add-ons
- Checkout Addons
- Conditional Shipping and Payments
- EU Vat Number
- FedEx
- MailChimp
- MailPoet
- Memberships
- Points and Rewards
- Product Bundles
- Pre-orders
- Smart Coupons
Extensibility ↑ Back to top
The extensibility interfaces for the cart and checkout blocks are still being developed. Because the blocks are completely new, extensibility interfaces are not final and are subject to change.
The cart and checkout blocks support selected payment methods (detailed above). Note that not all payment methods in the Stripe extension are supported at present.
The cart and checkout blocks do not currently support plugins that integrate with the cart and checkout shortcodes. In particular, extensions that use hooks related to cart and checkout may not function as expected. Extensions that render additional markup in cart or checkout – for example, custom checkout fields – are not supported.
If you’re developing extensions or customizations that integrate with cart and checkout, you can follow development progress, and provide feedback over on GitHub.