The Cart and Checkout Blocks are available for testing in WooCommerce, starting from version 6.9. These blocks are part of a ground-up rebuild of the checkout flow, based on industry best practices.
These new blocks are fully functional, but are not a complete, drop-in replacement for the existing cart and checkout shortcodes: Most extensions developed by WooCommerce fully support the block-based cart/checkout at this time. However, it is likely that a plugin/extension running on your store may not work as expected.
We have created this document to:
- Help you understand how to add the new blocks to your Cart and Checkout pages, in order to test them on your store.
- Share with you the latest information we have on extensions that have been integrated and tested to work with the Cart and Checkout Blocks, as well as extensions that are known to be incompatible.
Requirements
↑ Back to topTo use the Cart and Checkout Blocks, your site must:
- Have WooCommerce version 6.9 or newer installed. Alternatively, you may install the WooCommerce Blocks plugin, which is updated more frequently to include the latest version of these blocks.
- Use a supported payment gateway.
Using the Cart and Checkout Blocks
↑ Back to topReplacing the existing cart shortcode
↑ Back to topTo replace the existing cart shortcode with the Cart Block:
- Check that your site is running WooCommerce version 6.9 or newer — or download and install the WooCommerce Blocks plugin.
- Click on the the Pages menu item, and then locate and edit the Cart page.
- Delete the
[woocommerce_cart]
Shortcode block that generates the contents of your Cart page. - Search for the Cart Block, or locate it by navigating to the WooCommerce Blocks section.
- Choose the block to add it to your Cart page.
You should now see a preview of your block-based cart. You can use the settings in the sidebar to customize the Cart Block. Once you are ready, remember to click the Update button to save and publish your changes.
Replacing the existing checkout shortcode
↑ Back to topTo replace the existing checkout shortcode to use the Checkout Block:
- Check that your site is running WooCommerce version 6.9 or newer — or download and install the WooCommerce Blocks plugin.
- Click on the the Pages menu item, and then locate and edit the Checkout page.
- Delete the
[woocommerce_checkout]
Shortcode block that generates the contents of your Checkout page. - Search for the Checkout Block, or locate it by navigating to the WooCommerce Blocks section.
- Choose the block to add it to your Checkout page.
You should now see a preview of your block-based checkout. You can use the settings in the sidebar to customize the Checkout Block. Once you are ready, remember to click the Update button to save and publish your changes.
Compatible Extensions
↑ Back to topThe following list of extensions fully support the Cart and Checkout blocks. This list is continuously updated as more extensions are integrated with the blocks.
Payment Gateways
↑ Back to topPayment Method | Extension | Minimum Version |
---|---|---|
WooCommerce Payments | Available in WooCommerce or via the extension | WooCommerce Payments 1.6.0+ |
Bank Transfer (BACS) | n/a (included in WooCommerce Core) | WooCommerce Blocks 3.0+ |
Cash on Delivery | n/a (included in WooCommerce Core) | WooCommerce Blocks 3.0+ |
Cheque | n/a (included in WooCommerce Core) | WooCommerce Blocks 3.0+ |
Amazon Pay | Amazon Pay | WooCommerce Blocks 3.0+ Amazon Pay 2.3.0+ |
Eway | Eway | WooCommerce Blocks 3.0+ Eway 3.2.0+ |
PayFast | PayFast Payment Gateway | WooCommerce Blocks 3.0+ PayFast Payment Gateway 1.4.19+ |
PayPal Standard | n/a (included in WooCommerce Core before version 5.5.0, hidden in new installations since version 5.5.0) | WooCommerce Blocks 2.6+ |
Stripe – Credit Card | Stripe | WooCommerce Blocks 2.6+ Stripe 4.5.1+ |
Stripe – Payment Request (Apple Pay, Chrome Pay) | Stripe | WooCommerce Blocks 2.6+ Stripe 4.5.1+ |
Square – Credit Card | Square | WooCommerce Blocks 3.0+ Square 2.5.0+ |
Klarna Payments | Klarna Payments | WooCommerce Blocks 7.4+ Klarna Payments 3.0.0+ |
SnapScan | WooCommerce SnapScan Gateway | WooCommerce Blocks 7.4+ WooCommerce SnapScan Gateway 1.2.3+ |
Affirm Payments | Affirm Payments | WooCommerce Blocks 7.4+ Affirm Payments 2.0.0+ |
GoCardless | GoCardless | WooCommerce Blocks 7.4+ GoCardless 2.5.5+ |
WooCommerce Purchase Order Gateway | WooCommerce Purchase Order Gateway | WooCommerce Blocks 7.4+ WooCommerce Purchase Order Gateway 1.4.0+ |
Braintree for WooCommerce | Braintree for WooCommerce | WooCommerce Blocks 7.4+ Braintree 3.0.2+ |
Shipping Methods and Options
↑ Back to topShipping Method | Minimum Version |
---|---|
Australia Post | WooCommerce Blocks 3.0+ WordPress 5.2+ Australia Post 2.4.28+ |
Canada Post | WooCommerce Blocks 3.0+ WordPress 5.2+ Canada Post 2.5.19+ |
FedEx | WooCommerce Blocks 6.1.0+ WordPress 5.8+ Fedex Shipping 3.4.39+ |
Royal Mail | WooCommerce Blocks 3.0+ WordPress 5.2+ Royal Mail 2.5.32+ |
Shipment Tracking | WooCommerce Blocks 3.0+ WordPress 5.2+ Shipment Tracking1.8.0+ |
Table Rate Shipping | WooCommerce Blocks 3.0+ WordPress 5.2+ Table Rate Shipping 3.0.30+ |
Sendcloud | WooCommerce Blocks 3.0+ WordPress 5.2+ Sendcloud 2.2.9+ |
ShipStation for WooCommerce | WooCommerce Blocks 3.0+ WordPress 5.2+ ShipStation 4.1.49+ |
Skydropx | WooCommerce Blocks 3.0+ WordPress 5.2+ Skydropx 1.0.9+ |
UPS | WooCommerce Blocks 3.0+ WordPress 5.2+ UPS 3.2.30+ |
USPS | WooCommerce Blocks 3.0+ WordPress 5.2+ USPS 4.4.49+ |
WooCommerce Shipping and Tax | WooCommerce Blocks 3.0+ WordPress 5.2+ WooCommerce Shipping & Tax 1.25.9 |
Other Extensions
↑ Back to topExtension name | Minimum Version |
---|---|
All Products for WooCommerce Subscriptions | WooCommerce Blocks 7.3.0+ WordPress 5.8+ WooCommerce Subscriptions 4.2.0+ All Products for WooCommerce Subscriptions 3.3+ |
AutomateWoo | WooCommerce Blocks 5.6+ WordPress 5.8+ AutomateWoo 5.5+ |
Bookings | WooCommerce Blocks 7.3.0+ WordPress 5.8+ WooCommerce Bookings 1.15.54+ |
Box Office | WooCommerce Blocks 7.3+ WordPress 5.8+ Box Office 1.1+ |
Cart Add-ons | WooCommerce Blocks 7.4+ WordPress 5.8+ Cart Add-ons 2.3+ |
Composite Products | WooCommerce Blocks 7.3.0+ WordPress 5.8+ Composite Products 8.4.0+ |
Conditional Shipping and Payments | WooCommerce Blocks 7.3.0+ WordPress 5.8+ Conditional Shipping and Payments 1.13.0+ |
Facebook for WooCommerce | WooCommerce Blocks 3.0+ WordPress 5.2+ Facebook for WooCommerce 2.2.0+ |
Gift Cards | WooCommerce Blocks 7.0.0+ WordPress 5.5+ Gift Cards 1.11.0+ |
Gravity Forms Product Add-ons | WooCommerce Blocks 4.9+ WordPress 5.5+ Gravity Forms Product Add-ons 3.3.18+ |
EU VAT Number | WooCommerce Blocks 8.4.0+ WordPress 5.6+ EU VAT Number 2.8.0+ |
MailPoet | WooCommerce Blocks 6.3.0+ WordPress 5.8+ Mailpoet 3.74.2+ |
Name Your Price | WooCommerce Blocks 4.9+ WordPress 5.5+ Name Your Price 3.2.3+ |
Points & Rewards | WooCommerce Blocks 5.6+ WordPress 5.8+ Points & Rewards 1.7+ |
Pre-Orders | WooCommerce Blocks 7.2+ WordPress 5.8+ Pre-Orders 1.7+ |
Product Add-Ons | WooCommerce Blocks 4.5+ WordPress 5.4+ Product Add-Ons 3.4+ |
Product Bundles | WooCommerce Blocks 7.3.0+ WordPress 5.8+ Product Bundles 6.15.0+ |
Min/Max Quantities | WooCommerce Blocks 7.2.0+ WordPress 5.5+ Min/Max Quantities 3.0.0+ |
Mailchimp for WooCommerce | WooCommerce Blocks 8.0.0+ Mailchimp for WooCommerce 2.7+ |
Quickbooks Sync for WooCommerce | WooCommerce Blocks 4.9+ WordPress 5.5+ Quickbooks Sync for WooCommerce 2.2.1+ |
WooCommerce Deposits | WooCommerce Deposit 2.0+ WordPress 5.8+ WooCommerce Blocks v7.0.0 |
Shipping Locations Pro | WooCommerce Blocks 4.9+ WordPress 5.5+ Shipping Locations Pro 1.3+ |
Subscriptions | WooCommerce Blocks 4.9+ WordPress 5.5+ WooCommerce Subscriptions 3.1.0+ |
WooCommerce Google Analytics Only gTag (with a G- prefixed site ID) is supported. | WooCommerce Blocks 4.9+ WordPress 5.5+ WooCommerce Google Analytics 1.5+ |
Incompatible Extensions
↑ Back to topPayment gateways
↑ Back to topIf you use incompatible payment gateways with the Cart and Checkout Blocks, a warning will appear in the editor side of the Cart and Checkout Blocks:

We also display a warning under the incompatible payment gateways in the Payment Options Inner Block of the Checkout Block:

Payment Options Block
The following extensions are known to be incompatible with the Cart and Checkout Blocks. If you are using any of these extensions, we advise you keep using the shortcode-based checkout for now. We’ll be updating this list as more extensions are integrated with the new blocks.
- AMP (When AMP is enabled and in Standard mode, the Cart and Checkout block pages won’t load)
- Afterpay
- CC Avenue Payment Gateway
- Checkout Addons
- Checkout Field Editor
- Envia Shipping and Fulfillment
- Local Pickup Plus
- Memberships
- Razorpay Payment Gateway
- Smart Coupons
- WooCommerce PayPal Payments
- Authorize.Net CIM
- Google Analytics Pro
- PDF Product Vouchers
- Donations For WooCommerce
- Order Delivery for WooCommerce
- Dynamic Pricing
- Sage Pay
- Product Recommendations
- Packlink PRO
- Paystack
- PayU India
- Klaviyo: Email & Text Marketing for Ecommerce
- RedSys Gateway | Pasarela Redsys para WooCommerce
- Mercado Pago Checkout
- Mollie Payments for WooCommerce
- Wallee integration for WooCommerce
- PostFinance Checkout
Extensibility
↑ Back to topExtensibility interfaces for the Cart and Checkout Blocks are still under active development. If you are developing extensions or customizations that integrate with the WooCommerce cart and checkout, we highly encourage you to follow our progress and provide feedback on GitHub.
Extensions that use hooks to render additional markup in the cart or checkout pages – for example, custom checkout fields – usually require integration work to support the Cart and Checkout Blocks.
If you are using a plugin that does not work as expected with the Cart and Checkout Blocks, please get in touch with its developers and let them know that you would like to use the new, block-based checkout. To assist developers in this effort, we have published documentation and resources on integrating existing plugins with the Cart/Checkout Blocks and Store API.
Found a plugin that appears to be incompatible? Please open an issue to help us measure demand and prioritize extensibility work on our end.
Reverting to the Cart and Checkout shortcodes
↑ Back to topIf you discover any bugs or experience any issues while using the Cart/Checkout Blocks, you may switch back to the Cart/Checkout shortcodes. To help us resolve the issue for other merchants who may run into it, please consider opening an issue on GitHub before reverting to the shortcode-based checkout.
To switch back to the shortcode-based cart or checkout:
- Click on the the Pages menu item, and then locate and edit the Cart or Checkout page.
- In the Editor, enable the List View and then locate the Cart or Checkout Block.
- Select and delete the Cart or Checkout block.
- Add a new Shortcode block in its place.
- Type
[woocommerce_cart]
or[woocommerce_checkout]
in the Shortcode block, depending on whether you want to restore the shortcode-based cart or checkout. - Save your changes.
Frequently Asked Questions
↑ Back to topWill a page containing a Cart and Checkout blocks be automatically set as a Cart page and Checkout page?
↑ Back to topNo, you’ll need to change the pages used for the cart and checkout under WooCommerce > Settings > Advanced.
Which shipping methods, payment gateways, and other extensions are supported?
↑ Back to topCart and Checkout blocks are compatible with a variety of shipping, payment, and other extensions. For further information, check out this list of Compatible Extensions.
Where is the “Allow shoppers to sign up for a user account during checkout” option?
↑ Back to topIf 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.
Is it possible to go back to the old cart or checkout?
↑ Back to topYes, you can remove the Cart or Checkout block from a page and add back the shortcode. Please remember to double-check your page settings in WooCommerce > Settings > Advanced.