Starting with WooCommerce version 8.3, the Cart and Checkout Blocks are the default for new installations. These blocks are part of a ground-up rebuild of the checkout flow, based on industry best practices which offer conversion-optimized features and a simplified shopper flow. With easy customization options, you can maintain your brand identity and provide a visually appealing and consistent checkout journey for your customers.
These new blocks are fully functional and most extensions developed by WooCommerce fully support the block-based cart/checkout at this time. However, a plugin/extension running on your store may not work as expected. The cart and checkout shortcodes will continue to be available in WooCommerce Core for existing stores that have customized checkout flows requiring them, and for any new stores that have specific needs not yet possible with the Cart and Checkout blocks.
We have created this document to:
- Help you understand how to add the new blocks to your Cart and Checkout pages if your store was created before WooCommerce version 8.3.
- How to use the new Order Confirmation template with a Block theme if your store was created before WooCommerce version 8.3.
- Provide instructions on how to revert to the classic shortcodes should you need to.
- Share 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 topWith WooCommerce version 8.3+, the Cart and Checkout blocks are the default for new installations and when creating default pages with the tool under WooCommerce > Status > Tools > Create default WooCommerce pages
. For Block themes, starting with WooCommerce 8.3, the “blockified” Order Confirmation template is also the default for new installations.
For versions before 8.3, or if you removed the blocks and would like to switch back, you can follow the steps below.
Replacing 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.
Replacing the order confirmation page
↑ Back to topAfter placing an order via the Checkout Block, the customer will be redirected to the order confirmation page. If you’re using a block-based theme, you’ll have access to a dedicated Order Confirmation Template, as well as order confirmation blocks. This allows for customisation of your confirmation page.
With a block theme (such as Twenty Twenty-Three) navigate to Appearance > Editor > Templates > Order Confirmation
. You’ll see a representation of the existing Order Confirmation page in the editor. If you select the preview you can then use the “Transform into blocks” button:

You should now see a preview of your block-based order confirmation page. You can move the blocks around, or select them individually to adjust styling. Once you are ready, remember to click the Update button to save and publish your changes.
Reverting to the Cart and Checkout shortcodes
↑ Back to topIf you experience any issues while using the Cart/Checkout Blocks due to plugin incompatibilities, you may want to switch back to the Cart/Checkout shortcodes. If you experience different types of issues, please report them by opening a new issue.
Reverting to shortcodes with WooCommerce 8.3+
↑ Back to top
- Using a block theme: Go to Appearance -> Editor -> Pages -> Select Cart or Checkout -> click the Edit icon
Using a non-block theme: Go to Pages -> All Pages, and then locate and edit the Cart/Checkout page. - Open the List View and select the Cart or Checkout block.
- Open the Block Transform menu as seen above.
- Choose “Classic Shortcode”.
- The block will be transformed into a Classic Shortcode placeholder block.
- Save your changes by clicking the Update button in the top bar.
Reverting to shortcodes with WooCommerce <8.3
↑ Back to top- Using a block theme: Go to Appearance -> Editor -> Pages -> Select Cart or Checkout -> click the Edit icon
Using a non-block theme: Go to Pages -> All Pages, and then locate and edit the Cart/Checkout page. - Open the List View and select 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.
Reverting to the legacy order confirmation page
↑ Back to topThese steps only apply to Block themes.

- Open the Order Confirmation template in the Site Editor by navigating to Appearance -> Editor -> Templates > Order Confirmation.
- Open the List View and delete all the special Order Confirmation blocks (hold Shift to select multiple blocks between the current selection and the block you click).
- Open the Block Inserter, search for and add the Order Confirmation Block as shown above.
- Save 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 |
---|---|---|
WooPayments | Available in WooCommerce or via the extension | WooPayments 1.6.0+ |
PayPal, Pay Later, & Venmo – see Documentation and current support status | WooCommerce PayPal Payments (Partial support; smart buttons only) | WooCommerce Blocks 7.4+ WooCommerce PayPal Payments 2.3.0+ |
Stripe – Credit Card, Payment Request (Apple Pay, Chrome Pay) | Stripe | WooCommerce Blocks 2.6+ Stripe 4.5.1+ |
Klarna Payments | Klarna Payments | WooCommerce Blocks 7.4+ Klarna Payments 3.0.0+ |
Amazon Pay | Amazon Pay | WooCommerce Blocks 3.0+ Amazon Pay 2.3.0+ |
PayFast | PayFast Payment Gateway | WooCommerce Blocks 3.0+ PayFast Payment Gateway 1.4.19+ |
Affirm Payments | Affirm Payments | WooCommerce Blocks 7.4+ Affirm Payments 2.0.0+ |
Eway | Eway | WooCommerce Blocks 3.0+ Eway 3.2.0+ |
Square – Credit Card | Square | WooCommerce Blocks 3.0+ Square 2.5.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+ |
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+ |
e-Path Gateway | e-Path Gateway | WooCommerce Blocks 7.4+ e-Path Gateway 2.1.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+ |
PayPal Braintree | PayPal Braintree | WooCommerce Blocks 7.4+ Braintree 3.0.2+ |
Paystack | Paystack | Paystack 5.8.0+ |
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 Woo Subscriptions | WooCommerce Blocks 7.3.0+ WordPress 5.8+ WooCommerce Subscriptions 4.2.0+ All Products for Woo Subscriptions 3.3+ |
AutomateWoo | WooCommerce Blocks 5.6+ WordPress 5.8+ AutomateWoo 5.5+ |
AutomateWoo – Birthdays add-on | |
AutomateWoo – Refer A Friend add-on | AutomateWoo – Refer A Friend add-on 2.7.12+ |
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+ |
EU VAT Number | WooCommerce Blocks 8.4.0+ WordPress 5.6+ EU VAT Number 2.8.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+ |
Google Listings & Ads | Google Listings & Ads 2.5.10+ |
Gravity Forms Product Add-ons | WooCommerce Blocks 4.9+ WordPress 5.5+ Gravity Forms Product Add-ons 3.3.18+ |
Klaviyo – Ecommerce Marketing Platform | Klaviyo 3.2.0+ |
Mailchimp for WooCommerce | WooCommerce Blocks 8.0.0+ Mailchimp for WooCommerce 2.7+ |
MailPoet | WooCommerce Blocks 6.3.0+ WordPress 5.8+ Mailpoet 3.74.2+ |
Min/Max Quantities | WooCommerce Blocks 7.2.0+ WordPress 5.5+ Min/Max Quantities 3.0.0+ |
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+ |
Product Vendors | Product Vendors 2.1.80+ |
Quickbooks Sync for WooCommerce | WooCommerce Blocks 4.9+ WordPress 5.5+ Quickbooks Sync for WooCommerce 2.2.1+ |
Shipping Locations Pro | WooCommerce Blocks 4.9+ WordPress 5.5+ Shipping Locations Pro 1.3+ |
WooCommerce Deposits | WooCommerce Deposit 2.0+ WordPress 5.8+ WooCommerce Blocks v7.0.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+ |
Woo Subscriptions | WooCommerce Blocks 4.9+ WordPress 5.5+ Woo Subscriptions 3.1.0+ |
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:

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
- Authorize.Net CIM
- Google Analytics Pro
- PDF Product Vouchers
- Donations For WooCommerce
- Order Delivery for WooCommerce
- Dynamic Pricing
- Sage Pay
- Product Recommendations
- Packlink PRO
- PayU India
- 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.
Frequently Asked Questions
↑ Back to topWill a page containing a Cart and Checkout block 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.