WooCommerce 10.6.1 is a maintenance release, and it clears up a few things that had been costing developers and store owners real time. If variable products have been failing in the Add to Cart block, this is the release you want.
Dot releases exist to catch what the major version missed. This one covers attribute normalization, where payment gateways sit in the settings list, and the shipping labels on the checkout page.
Hyphens against spaces
The fix with the most substance behind it is attribute validation in the Add to Cart with Options block. PHP was handling attribute names as slugs, color-theme, while the Store API returned labels with spaces, color theme. Validation compared the two strictly, and a hyphen is not a space, so a perfectly valid selection came back invalid.
The patch updates normalizeAttributeName() so both sides format the name the same way before anything gets compared.
// A conceptual look at the normalization fix
function bbioon_normalize_attribute_example( $name ) {
// Ensuring hyphens are treated as spaces for consistent validation
return str_replace( '-', ' ', strtolower( $name ) );
}I covered how these API changes land on a live store in my breakdown of WooCommerce 10.6 performance updates.
Payment gateway order
Newly installed gateways used to land at the bottom of the settings list, below offline methods like cheque and bank transfer. Sitting down there also meant they were not expanded by default on the checkout page.
WooCommerce 10.6.1 flips that. A new gateway now appears above the offline methods unless the merchant has set a custom order by hand. For a store that has just installed a card gateway, the difference shows up in conversions.
Shipping labels
The last one is cosmetic. A customer with a single shipping package still saw it labeled “Shipment 1”, which reads like the store expected more packages and lost them. get_shipping_package_name() now detects the single-package case and labels it “Shipment”.
If your Add to Cart button has been misbehaving, it is worth reading why buttons broke in 10.5.1 before you assume this release covers it.
If WooCommerce 10.6.1 is eating your dev hours, I can take it off your plate. I have been working on WordPress since the 4.x days.
Worth updating for
The version number says minor, but the attribute fix matters to any store running variable products through the block editor. The official release notes have the full list, and the hyphen fix itself is GitHub PR #63647. Clear your transients after updating and push a variation through checkout before you call it done.
