In the world of WordPress development, we often treat dot releases with a mix of relief and skepticism. WooCommerce 10.6.1 just dropped, and while it’s a maintenance release, it tackles a few “gotchas” that have been causing friction for both developers and store owners. If you’ve been seeing variable products break in the Add to Cart block, this one is specifically for you.
Maintenance releases like this are usually about refining the edge cases that slipped through the cracks of a major version. This update primarily focuses on attribute normalization, payment gateway UX, and cleaning up shipping labels on the checkout page.
The Normalization Headache: Hyphens vs. Spaces
The most technical fix in WooCommerce 10.6.1 involves how attributes are validated in the Add to Cart with Options block. This was a classic “race condition” of data formats. PHP typically handles attribute names as slugs (e.g., color-theme), but the Store API was returning labels with spaces (e.g., color theme). When the system performed a strict comparison to validate the selection, it failed because a hyphen doesn’t equal a space.
The fix involved updating the normalizeAttributeName() method to ensure consistent formatting across all comparison points. It’s a reminder of why consistent data sanitization is the backbone of a stable API.
// 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 ) );
}For more context on how these API changes affect your store, check out my previous breakdown on WooCommerce 10.6 Performance Updates.
Payment Gateway Visibility and UX
Another significant change involves the ordering of payment gateways. Previously, newly installed gateways were being dumped at the very bottom of the list in the settings. This meant they were often buried below offline methods like “Cheque” or “Bank Transfer,” preventing them from being expanded by default on the checkout page.
WooCommerce 10.6.1 corrects this logic. Now, new gateways will appear above offline methods unless a merchant has manually defined a custom order. This is a small but vital change for conversion optimization; you want your most modern payment methods front and center.
Cleaning Up Shipping Labels
The final notable fix is purely cosmetic but helps with professional branding. In previous versions, even if a customer only had one shipping package, it would display as “Shipment 1.” This looked a bit amateurish—like the system was expecting more but failed to find them. The get_shipping_package_name() method now correctly identifies when there’s only a single package and simply labels it as “Shipment.”
If you’ve noticed your “Add to Cart” button acting up recently, you might also want to read about why buttons broke in 10.5.1 to ensure you’re not carrying over legacy bugs.
Look, if this WooCommerce 10.6.1 stuff is eating up your dev hours, let me handle it. I’ve been wrestling with WordPress since the 4.x days.
Final Takeaway for Developers
Don’t ignore this update. While it’s a “minor” release, the attribute hyphen fix is critical for any store running variable products through the Block editor. You can find the full technical details in the official release notes and track the specific hyphen fix on GitHub PR #63647. Keep your core updated, your transients cleared, and your checkout smooth.
