1. Documentation /
  2. Cart and Checkout Blocks: Status

Cart and Checkout Blocks: Status

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 top

To 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 top

Replacing the existing cart shortcode

↑ Back to top

To replace the existing cart shortcode with the Cart Block:

  1. Check that your site is running WooCommerce version 6.9 or newer — or download and install the WooCommerce Blocks plugin.
  2. Click on the the Pages menu item, and then locate and edit the Cart page.
  3. Delete the [woocommerce_cart] Shortcode block that generates the contents of your Cart page.
  4. Search for the Cart Block, or locate it by navigating to the WooCommerce Blocks section.
  5. 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 top

To replace the existing checkout shortcode to use the Checkout Block:

  1. Check that your site is running WooCommerce version 6.9 or newer — or download and install the WooCommerce Blocks plugin.
  2. Click on the the Pages menu item, and then locate and edit the Checkout page.
  3. Delete the [woocommerce_checkout] Shortcode block that generates the contents of your Checkout page.
  4. Search for the Checkout Block, or locate it by navigating to the WooCommerce Blocks section.
  5. 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 top

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

If you’re using a block based 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:

Transforming the template into blocks

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.

Compatible Extensions

↑ Back to top

The 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 top
Payment MethodExtensionMinimum Version
WooPaymentsAvailable in WooCommerce or via the extensionWooPayments 1.6.0+
PayPal, Pay Later, & Venmo

– see Documentation and current support status		WooCommerce PayPal PaymentsWooCommerce Blocks 7.4+
WooCommerce PayPal Payments 2.3.0+
Stripe – Credit Card, Payment Request
(Apple Pay, Chrome Pay)		StripeWooCommerce Blocks 2.6+
Stripe 4.5.1+
Klarna Payments Klarna PaymentsWooCommerce Blocks 7.4+
Klarna Payments 3.0.0+
Amazon PayAmazon PayWooCommerce Blocks 3.0+
Amazon Pay 2.3.0+
PayFastPayFast Payment GatewayWooCommerce Blocks 3.0+
PayFast Payment Gateway 1.4.19+
Affirm Payments
Affirm PaymentsWooCommerce Blocks 7.4+
Affirm Payments 2.0.0+
EwayEwayWooCommerce Blocks 3.0+
Eway 3.2.0+
Square – Credit CardSquareWooCommerce 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+
Chequen/a (included in WooCommerce Core)WooCommerce Blocks 3.0+
PayPal Standardn/a (included in WooCommerce Core before version 5.5.0, hidden in new installations since version 5.5.0)WooCommerce Blocks 2.6+
SnapScanWooCommerce SnapScan GatewayWooCommerce Blocks 7.4+
WooCommerce SnapScan Gateway 1.2.3+
GoCardlessGoCardlessWooCommerce Blocks 7.4+
GoCardless 2.5.5+
WooCommerce Purchase Order GatewayWooCommerce Purchase Order GatewayWooCommerce Blocks 7.4+
WooCommerce Purchase Order Gateway 1.4.0+
Braintree for WooCommerceBraintree for WooCommerceWooCommerce Blocks 7.4+
Braintree 3.0.2+

Shipping Methods and Options

↑ Back to top
Shipping MethodMinimum Version
Australia PostWooCommerce Blocks 3.0+
WordPress 5.2+
Australia Post 2.4.28+
Canada PostWooCommerce Blocks 3.0+
WordPress 5.2+
Canada Post 2.5.19+
FedExWooCommerce Blocks 6.1.0+
WordPress 5.8+
Fedex Shipping 3.4.39+
Royal MailWooCommerce Blocks 3.0+
WordPress 5.2+
Royal Mail 2.5.32+
Shipment TrackingWooCommerce Blocks 3.0+
WordPress 5.2+
Shipment Tracking1.8.0+
Table Rate ShippingWooCommerce Blocks 3.0+
WordPress 5.2+
Table Rate Shipping 3.0.30+
SendcloudWooCommerce Blocks 3.0+
WordPress 5.2+
Sendcloud 2.2.9+
ShipStation for WooCommerceWooCommerce Blocks 3.0+
WordPress 5.2+
ShipStation 4.1.49+
SkydropxWooCommerce Blocks 3.0+
WordPress 5.2+
Skydropx 1.0.9+
UPSWooCommerce Blocks 3.0+
WordPress 5.2+
UPS 3.2.30+
USPSWooCommerce Blocks 3.0+
WordPress 5.2+
USPS 4.4.49+
WooCommerce Shipping and TaxWooCommerce Blocks 3.0+
WordPress 5.2+
WooCommerce Shipping & Tax 1.25.9

Other Extensions

↑ Back to top
Extension nameMinimum Version
All Products for WooCommerce SubscriptionsWooCommerce Blocks 7.3.0+
WordPress 5.8+
WooCommerce Subscriptions 4.2.0+
All Products for WooCommerce Subscriptions 3.3+
AutomateWooWooCommerce Blocks 5.6+
WordPress 5.8+
AutomateWoo 5.5+
BookingsWooCommerce Blocks 7.3.0+
WordPress 5.8+
WooCommerce Bookings 1.15.54+
Box OfficeWooCommerce Blocks 7.3+
WordPress 5.8+
Box Office 1.1+
Cart Add-onsWooCommerce Blocks 7.4+
WordPress 5.8+
Cart Add-ons 2.3+
Composite ProductsWooCommerce Blocks 7.3.0+
WordPress 5.8+
Composite Products 8.4.0+
Conditional Shipping and PaymentsWooCommerce Blocks 7.3.0+
WordPress 5.8+
Conditional Shipping and Payments 1.13.0+
EU VAT NumberWooCommerce Blocks 8.4.0+
WordPress 5.6+
EU VAT Number 2.8.0+
Facebook for WooCommerceWooCommerce Blocks 3.0+
WordPress 5.2+
Facebook for WooCommerce 2.2.0+
Gift CardsWooCommerce Blocks 7.0.0+
WordPress 5.5+
Gift Cards 1.11.0+
Gravity Forms Product Add-onsWooCommerce Blocks 4.9+
WordPress 5.5+
Gravity Forms Product Add-ons 3.3.18+
Klaviyo – Ecommerce Marketing PlatformKlaviyo 3.2.0+
Mailchimp for WooCommerceWooCommerce Blocks 8.0.0+
Mailchimp for WooCommerce 2.7+
MailPoetWooCommerce Blocks 6.3.0+
WordPress 5.8+
Mailpoet 3.74.2+
Min/Max QuantitiesWooCommerce Blocks 7.2.0+
WordPress 5.5+
Min/Max Quantities 3.0.0+
Name Your PriceWooCommerce Blocks 4.9+
WordPress 5.5+
Name Your Price 3.2.3+
Points & RewardsWooCommerce Blocks 5.6+
WordPress 5.8+
Points & Rewards 1.7+
Pre-OrdersWooCommerce Blocks 7.2+
WordPress 5.8+
Pre-Orders 1.7+
Product Add-OnsWooCommerce 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 VendorsProduct Vendors 2.1.80+
Quickbooks Sync for WooCommerceWooCommerce Blocks 4.9+
WordPress 5.5+
Quickbooks Sync for WooCommerce 2.2.1+
Shipping Locations ProWooCommerce Blocks 4.9+
WordPress 5.5+
Shipping Locations Pro 1.3+
WooCommerce DepositsWooCommerce 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+
WooCommerce SubscriptionsWooCommerce Blocks 4.9+
WordPress 5.5+
WooCommerce Subscriptions 3.1.0+

Incompatible Extensions

↑ Back to top

Payment gateways

↑ Back to top

If 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:

Highlighting incompatible payment gateways using a sidebar notice

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

Highlighting incompatible payment gateways within the 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
  • 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
  • RedSys Gateway | Pasarela Redsys para WooCommerce
  • Mercado Pago Checkout
  • Mollie Payments for WooCommerce
  • Wallee integration for WooCommerce
  • PostFinance Checkout

Extensibility

↑ Back to top

Extensibility 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 top

If 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:

  1. Click on the the Pages menu item, and then locate and edit the Cart or Checkout page.
  2. In the Editor, enable the List View and then locate the Cart or Checkout Block.
  3. Select and delete the Cart or Checkout block.
  4. Add a new Shortcode block in its place.
  5. Type [woocommerce_cart] or [woocommerce_checkout] in the Shortcode block, depending on whether you want to restore the shortcode-based cart or checkout.
  6. Save your changes.

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 under 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, check out this list of Compatible Extensions.

Where is the “Allow shoppers to sign up for a user account during checkout” option?

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

Is it possible to go back to the old cart or checkout?

↑ Back to top

Yes, 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.