Commit 569f4ffd581 for woocommerce
commit 569f4ffd5814e9447cb1728ac8da396cf51769dd
Author: Luigi Teschio <gigitux@gmail.com>
Date: Fri Aug 7 16:16:41 2026 +0200
Clarify variation taxonomy attribute values (#67441)
* Clarify variation taxonomy attribute values
* Add changelog entry for variation attribute documentation
* Improve variation attribute documentation example
* Apply suggestion from @kmanijak
Co-authored-by: Karol Manijak <20098064+kmanijak@users.noreply.github.com>
* improve doc
---------
Co-authored-by: Karol Manijak <20098064+kmanijak@users.noreply.github.com>
diff --git a/plugins/woocommerce/changelog/docs-variation-attribute-term-slugs b/plugins/woocommerce/changelog/docs-variation-attribute-term-slugs
new file mode 100644
index 00000000000..7ab13dd134e
--- /dev/null
+++ b/plugins/woocommerce/changelog/docs-variation-attribute-term-slugs
@@ -0,0 +1,4 @@
+Significance: patch
+Type: dev
+
+Clarify that variation taxonomy attribute values must use term slugs.
diff --git a/plugins/woocommerce/includes/class-wc-product-variation.php b/plugins/woocommerce/includes/class-wc-product-variation.php
index dff98f8ff1d..f8282cfeb66 100644
--- a/plugins/woocommerce/includes/class-wc-product-variation.php
+++ b/plugins/woocommerce/includes/class-wc-product-variation.php
@@ -509,9 +509,21 @@ class WC_Product_Variation extends WC_Product_Simple {
/**
* Set attributes. Unlike the parent product which uses terms, variations are assigned
- * specific attributes using name value pairs.
+ * specific attributes using name-value pairs. Taxonomy attribute values must use term
+ * slugs, which can be URL-encoded and differ from the term name.
*
- * @param array $raw_attributes array of raw attributes.
+ * For example, if a global "Size" attribute has a term named "7½", whose stored
+ * slug is "7%c2%bd", configure the variation using that term slug:
+ *
+ * $variation->set_attributes(
+ * array(
+ * 'pa_size' => '7%c2%bd',
+ * )
+ * );
+ *
+ * @param array $raw_attributes Array of raw attributes.
+ *
+ * @since 3.0.0
*/
public function set_attributes( $raw_attributes ) {
$raw_attributes = (array) $raw_attributes;