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 continuously 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+ |
| Eway | Eway | WooCommerce Blocks v3.0+ Eway 3.2.0+ |
| PayFast | PayFast Payment Gateway | PayFast Payment Gateway 1.4.19+ WordPress v4.4+ WooCommerce Blocks v3.0+ |
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+ |
| FedEx | WooCommerce Blocks v6.1.0+ WordPress 5.8+ Fedex Shipping 3.4.39+ |
Other Extensions ↑ Back to top
| Extension name | Minimum Version |
|---|---|
| All Products for WooCommerce Subscriptions | WooCommerce Blocks v7.3.0+ WordPress 5.8+ WooCommerce Subscriptions v4.2.0+ All Products for WooCommerce Subscriptions v3.3+ |
| AutomateWoo | WooCommerce Blocks v5.6+ WordPress 5.8+ AutomateWoo 5.5+ |
| Bookings | WooCommerce Blocks v7.3.0+ WordPress 5.8+ WooCommerce Bookings 1.15.54+ |
| Box Office | WooCommerce Blocks v7.3+ WordPress 5.8+ Box Office 1.1+ |
| Cart Add-ons | WooCommerce Blocks v7.4+ WordPress 5.8+ Cart Add-ons 2.3+ |
| Composite Products | WooCommerce Blocks v7.3.0+ WordPress 5.8+ Composite Products 8.4.0+ |
| Conditional Shipping and Payments | WooCommerce Blocks v7.3.0+ WordPress 5.8+ Conditional Shipping and Payments 1.13.0+ |
| Facebook for WooCommerce | WooCommerce Blocks v3.0+ WordPress 5.2+ Facebook for WooCommerce 2.2.0+ |
| Gravity Forms Product Add-ons | WooCommerce Blocks v4.9+ WordPress 5.5+ Gravity Forms Product Add-ons 3.3.18+ |
| MailPoet | WooCommerce Blocks v6.3.0+ WordPress 5.8+ Mailpoet 3.74.2+ |
| Name Your Price | WooCommerce Blocks v4.9+ WordPress 5.5+ Name Your Price 3.2.3+ |
| Points & Rewards | WooCommerce Blocks v5.6+ WordPress 5.8+ Points & Rewards 1.7+ |
| Pre-Orders | WooCommerce Blocks v7.2+ WordPress 5.8+ Pre-Orders 1.7+ |
| Product Add-Ons | WooCommerce Blocks v4.5+ WordPress 5.4+ Product Add-Ons 3.4+ |
Product Bundles | WooCommerce Blocks v7.3.0+ WordPress 5.8+ Product Bundles 6.15.0+ |
| Quickbooks Sync for WooCommerce | WooCommerce Blocks v4.9+ WordPress 5.5+ Quickbooks Sync for WooCommerce 2.2.1+ |
| Shipping Locations Pro | WooCommerce Blocks v4.9+ WordPress 5.5+ Shipping Locations Pro 1.3+ |
| Subscriptions | WooCommerce Blocks v4.9+ WordPress 5.5+ WooCommerce Subscriptions 3.1.0+ |
| 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+ |
Incompatible Extensions ↑ Back to top
Note: If you are using a plugin that isn’t working with the Cart and Checkout Blocks, please notify the developer of the extension and ask if they can add support. It’s up to the extension developers to add support for these Blocks. We have some documentation for Third-party developers and some Developer Resources available to help with their integration efforts.
We encourage you to also comment about your interest in one of the Incompatible plugins GitHub issues we use for tracking purposes
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.
- WooCommerce PayPal Payments
- Amazon Pay
- AMP (When AMP is enabled and on Standard mode, the Cart and Checkout block pages won’t load)
- Checkout Addons
- Checkout Field Editor
- EU Vat Number
- MailChimp
- Memberships
- Razorpay Payment Gateway
- Smart Coupons
- Local Pickup Plus
- Klarna Payments
- WooCommerce Purchase Order Gateway
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.
Frequently Asked Questions ↑ Back to top
Will a page containing a Cart and Checkout blocks be automatically set as a Cart page and Checkout page? ↑ Back to top
No, you’ll need to change the pages used for the cart and checkout in WooCommerce > Settings > Advanced.
Which shipping methods, payment gateways, and other extensions are supported? ↑ Back to top
Cart and Checkout blocks are compatible with a variety of shipping, payment, and other extensions. For further information, see the list of Compatible Extensions.
Why won’t the checkbox “Allow shoppers to sign up for a user account during checkout” show up? ↑ Back to top
If you add the Checkout Block and choose the “Contact Information” inner block, you will see the option Allow shoppers to sign up for a user account during checkout under “Account options” in the sidebar.
This option will add a checkbox for the user to create an account. However, this won’t be shown until the Allow customers to place orders without an account option in WooCommerce > Settings > Accounts & Privacy is turned on.
Can a user go back to the old cart or checkout? ↑ Back to top
Yes, the user can remove the Cart or Checkout block from a page and add back the shortcode. And, if they have set up different pages with shortcodes then they can update the page settings in WooCommerce > Settings > Advanced.
Why are the settings that I saved on the Cart/Checkout block not present on shortcode pages? ↑ Back to top
The settings for the Cart and Checkout Block are independent of the ones for the shortcode, and the other way around.