The documentation for WooCommerce Blocks has moved to the WooCommerce monorepo.
Please refer to the documentation in the new location as the files in this repository will no longer be updated and the repository will be archived.
Zip file for testing: woocommerce-gutenberg-products-block.zip
Load Interactivity API in bootstrap.php
. #10657
Note Ignore the first step if testing in WooCommerce Core.
- Install this custom build of WooCommerce that includes this patch: woocommerce.zip.
- Make sure that
WooCommerce Blocks
plugin is not active. - Open the Site Editor and ensure that you are using the blockified template on the Product Catalog template.
- Visit the
/shop
page and ensure that the Product Button(Add to Cart) works as expected.
Make View Cart link displayed below the Add to Cart button. #10675
- Edit Product Catalog template
- Add Products (Beta) block if it's not there already
- Save and go to frontend
- Add a simple product to cart
- Expected: "View Cart" link appears BELOW the Add to Cart button
Before:
![]() |
After:
![]() |
Fix: Made migration migrate block templates in the current theme. #10641
- Install a theme that uses block templates. In my case I used FotaWP.
- Go to Appearance > Edit > Templates and reset the cart/checkout templates to default.
- Delete has_migrated_cart and has_migrated_checkout options from your options database.
- View a page on the store.
- Confirm by viewing the cart and checkout pages that they inherited the block template from the theme. In this case for instance, instead of the default distraction free template we had, you'll see something like this:
Fix/10530 Inconsistent new install behaviour for templates when using block themes. #10608
- Get a new env ready to install WP/WC using WP-CLI. You can use this quick docker setup
- Alias or copy this branch, built ready to use as a plugin into the env
- Using WP-CLI set up WC using the following command sequence (alter args to suit your case)
wp config create --dbname=wordpress --dbuser=wordpress --dbpass=wordpress --dbhost=db --force
wp core install --url=http://localhost --title='WP Staging' --admin_user=admin --admin_password=pass [email protected]
wp option set blog_public 0
wp plugin activate woocommerce-blocks
wp plugin install woocommerce --version=6.0.0
wp plugin activate woocommerce
wp plugin install wordpress-importer --activate
wp import ./wp-content/plugins/woocommerce/sample-data/sample_products.xml --authors=skip
wp plugin update woocommerce
- Visit the store for the first time, head to Appearance > Editor > Templates > Manage all templates verify that Cart and Checkout have customizations saved
- Open each one and verify they contain the shortcode version
- Test the complete checkout flow.