Checkout blocks in WooCommerce

Last modified:

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. While we welcome change that drives WooCommerce forward, this also presents some difficulties with embedded checkouts.

The new block checkout makes it harder to make modifications via filters and custom template files, which embedded checkouts rely on.

With an embedded checkout, both the customer address and payment methods (and in some cases also shipping) are handled within the checkout. But the cart summary, selection of shipping, handling of coupon codes, etc., are handled by WooCommerce.

At the moment, there is unfortunately no clear way forward on how to handle this in the best way possible. We are discussing this issue with Automattic, and some of what has come out of these talks can be found here: https://developer.woo.com/2023/10/31/extending-the-future-a-dialogue-on-woocommerce-extensibility/

We are working on a solution for embedded checkouts and the block-based checkout, but currently we do not have an ETA for when it will be solved.

Using the Checkout shortcode

When using a payment plugin that does not support the Checkout block, you need to make sure you are using the checkout shortcode on the page you have set as your Checkout page.

Navigate to Pages → your Checkout page and transform the Checkout block to the Classic Shortcode block.

Embedded checkouts

The Krokedil plugins with embedded, or iframe-based, checkouts are Avarda Checkout, Kustom Checkout, Nexi Checkout, Walley Checkout and Qliro.