WooCommerce 10.6.1 maintenance release
Released , WooCommerce 10.6.1 focuses on targeted fixes that improve block-based product selection, admin payment setup, and shipping package labelling. Full details are available in the WooCommerce 10.6.1 dot release notes.
Block fix: attribute validation in Add to Cart with Options
What broke
Variable product attribute options could be incorrectly disabled in the Add to Cart with Options block when attribute slugs included hyphens. The mismatch came from PHP providing attribute names as slugs such as “some-name”, while the Store API returned labels formatted with spaces such as “some name”. Strict comparisons then failed, so valid options were treated as invalid.
What changed
The normalisation layer has been tightened so comparisons are made on like-for-like values. The normalizeAttributeName() logic now replaces hyphens with spaces, aligning the normalised output across PHP input and Store API responses. This prevents legitimate attribute options being disabled during selection.
SEO and conversion impact
For stores relying on block-based product pages, disabled variations can present as “out of stock” behaviour to shoppers and may reduce add-to-basket completion. Fixing attribute validation reduces false dead ends in the purchase path and helps maintain consistent variant availability signals across templates.
Admin UX fix: payment gateway ordering in settings
What broke
Newly installed payment gateways were appended below offline methods, which often meant the new gateway was not expanded by default on checkout and was harder to find and configure in the payment settings list.
What changed
The placement logic now inserts newly installed gateways above the offline payment group, unless a merchant has already customised ordering. This preserves intentional sequencing while making fresh installations immediately visible for configuration and checkout testing.
Checkout display fix: shipping package titles in shortcode output
What broke
When only one shipping package existed, the shortcode output could show “Shipment 1”, which reads like an incomplete multi-shipment scenario and can confuse customers at address and shipping steps.
What changed
The get_shipping_package_name() method now receives the total package count. With that context, a single package is labelled “Shipment”, while multiple packages continue to use numbered labels such as “Shipment 1” and “Shipment 2”.
FAQ
When was WooCommerce 10.6.1 released?
WooCommerce 10.6.1 was released on .
What does WooCommerce 10.6.1 fix in the Add to Cart with Options block?
It fixes variable product attribute options being incorrectly disabled when attribute slugs contain hyphens, by updating attribute name normalisation to replace hyphens with spaces so strict comparisons match Store API labels.
How has payment gateway ordering changed in WooCommerce 10.6.1?
Newly installed payment gateways are now inserted above offline payment methods in settings, unless the merchant has already customised the gateway order.
Why did “Shipment 1” appear for single-package checkouts, and what is the new behaviour?
The naming method did not have package count context. It now receives the total number of packages, so a single package displays as “Shipment”, while multiple packages remain numbered.
Where can I read the official WooCommerce 10.6.1 release notes?
Read the official post on the WooCommerce Developer Blog: WooCommerce 10.6.1 dot release notes.
