Commit f77b22cb818 for woocommerce
commit f77b22cb8189c2dc2b7189d599d52477faccdb1d
Author: Poli Gilad <83961704+poligilad-auto@users.noreply.github.com>
Date: Wed Jul 1 16:04:07 2026 +0200
Update Product Filters description copy (#65925)
* Update product filter description copy
* Trigger live branch build
* Update product filter copy per review
* Align taxonomy filter copy
* Capitalize availability filter title
* Remove product filter copy tests
diff --git a/plugins/woocommerce/changelog/update-product-filter-copy b/plugins/woocommerce/changelog/update-product-filter-copy
new file mode 100644
index 00000000000..2613adaec2b
--- /dev/null
+++ b/plugins/woocommerce/changelog/update-product-filter-copy
@@ -0,0 +1,4 @@
+Significance: patch
+Type: tweak
+
+Standardize copy for Product Filters descriptions.
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/block.json b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/block.json
index 58285ee6921..73d863a6116 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/block.json
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/block.json
@@ -3,7 +3,7 @@
"apiVersion": 3,
"name": "woocommerce/product-filters",
"title": "Product Filters",
- "description": "Let shoppers filter products displayed on the page.",
+ "description": "Add a set of filters shoppers can use.",
"category": "woocommerce",
"keywords": [ "WooCommerce" ],
"supports": {
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/edit.tsx b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/edit.tsx
index 464a9b695dc..346f1fb25f8 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/edit.tsx
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/edit.tsx
@@ -149,13 +149,13 @@ export const Edit = ( props: BlockEditProps< BlockAttributes > ) => {
<PanelBody title={ __( 'Settings', 'woocommerce' ) }>
<ToggleControl
label={ __(
- 'Use drawer on small screens',
+ 'Collapse filters on small screens',
'woocommerce'
) }
help={
showFilterDrawer
? __(
- 'Shoppers tap the button to open filters.',
+ 'Shoppers tap a button to open filters.',
'woocommerce'
)
: __(
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/active-filters/block.json b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/active-filters/block.json
index 8293c6b8b59..c2d55ca310f 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/active-filters/block.json
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/active-filters/block.json
@@ -2,7 +2,7 @@
"$schema": "https://schemas.wp.org/trunk/block.json",
"name": "woocommerce/product-filter-active",
"title": "Active Filters",
- "description": "Display the currently active filters.",
+ "description": "Display all active filters.",
"category": "woocommerce",
"keywords": [ "WooCommerce" ],
"textdomain": "woocommerce",
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/attribute-filter/block.json b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/attribute-filter/block.json
index 9f648bf2f25..d319e4e041a 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/attribute-filter/block.json
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/attribute-filter/block.json
@@ -2,7 +2,7 @@
"$schema": "https://schemas.wp.org/trunk/block.json",
"name": "woocommerce/product-filter-attribute",
"title": "Attribute Filter",
- "description": "Enable customers to filter the product grid by selecting one or more attributes, such as color.",
+ "description": "Let shoppers filter products by attribute.",
"category": "woocommerce",
"keywords": [ "WooCommerce" ],
"textdomain": "woocommerce",
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/attribute-filter/index.tsx b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/attribute-filter/index.tsx
index 831a793fdca..0e9ecac03bc 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/attribute-filter/index.tsx
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/attribute-filter/index.tsx
@@ -40,11 +40,8 @@ registerBlockType( metadata, {
),
description: sprintf(
// translators: %s is the attribute label.
- __(
- `Enable customers to filter the product collection by selecting one or more %s attributes.`,
- 'woocommerce'
- ),
- attribute.attribute_label
+ __( 'Let shoppers filter products by %s.', 'woocommerce' ),
+ attribute.attribute_label.toLocaleLowerCase()
),
attributes: {
attributeId: parseInt( attribute.attribute_id, 10 ),
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/checkbox-list/block.json b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/checkbox-list/block.json
index f3d3715c64c..5ca81b02831 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/checkbox-list/block.json
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/checkbox-list/block.json
@@ -2,7 +2,7 @@
"$schema": "https://schemas.wp.org/trunk/block.json",
"name": "woocommerce/product-filter-checkbox-list",
"title": "List",
- "description": "Display a list of filter options.",
+ "description": "Display filter options as a list.",
"category": "woocommerce",
"keywords": [ "WooCommerce" ],
"textdomain": "woocommerce",
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/clear-button/block.json b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/clear-button/block.json
index 73bbb50fd1d..fe72d4dfe1a 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/clear-button/block.json
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/clear-button/block.json
@@ -2,7 +2,7 @@
"$schema": "https://schemas.wp.org/trunk/block.json",
"name": "woocommerce/product-filter-clear-button",
"title": "Clear filters",
- "description": "Allows shoppers to clear active filters.",
+ "description": "Let shoppers clear any active filters.",
"category": "woocommerce",
"keywords": [ "WooCommerce", "clear filters" ],
"textdomain": "woocommerce",
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/price-filter/block.json b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/price-filter/block.json
index e41aabaa7fd..90018500cc6 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/price-filter/block.json
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/price-filter/block.json
@@ -2,7 +2,7 @@
"$schema": "https://schemas.wp.org/trunk/block.json",
"name": "woocommerce/product-filter-price",
"title": "Price Filter",
- "description": "Let shoppers filter products by choosing a price range.",
+ "description": "Let shoppers filter products by price.",
"category": "woocommerce",
"keywords": [ "WooCommerce" ],
"textdomain": "woocommerce",
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/price-slider/block.json b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/price-slider/block.json
index 0a7fce0ef1b..497a80ee61e 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/price-slider/block.json
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/price-slider/block.json
@@ -1,7 +1,7 @@
{
"name": "woocommerce/product-filter-price-slider",
"title": "Price Slider",
- "description": "A slider helps shopper choose a price range.",
+ "description": "Let shoppers choose a price range with a slider.",
"category": "woocommerce",
"keywords": [ "WooCommerce" ],
"supports": {
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/rating-filter/block.json b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/rating-filter/block.json
index 075141ed290..a7732b69be1 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/rating-filter/block.json
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/rating-filter/block.json
@@ -1,7 +1,7 @@
{
"name": "woocommerce/product-filter-rating",
"title": "Rating Filter",
- "description": "Enable customers to filter the product collection by rating.",
+ "description": "Let shoppers filter products by rating.",
"category": "woocommerce",
"keywords": [],
"supports": {
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/removable-chips/block.json b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/removable-chips/block.json
index 44f8b14b2b4..30b4a61d0f5 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/removable-chips/block.json
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/removable-chips/block.json
@@ -2,7 +2,7 @@
"$schema": "https://schemas.wp.org/trunk/block.json",
"name": "woocommerce/product-filter-removable-chips",
"title": "Chips",
- "description": "Display removable active filters as chips.",
+ "description": "Display active filters as removable chips.",
"category": "woocommerce",
"keywords": [ "WooCommerce" ],
"textdomain": "woocommerce",
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/status-filter/block.json b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/status-filter/block.json
index cf095878049..bbd621d79a5 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/status-filter/block.json
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/status-filter/block.json
@@ -1,6 +1,6 @@
{
"name": "woocommerce/product-filter-status",
- "title": "Availability filter",
+ "title": "Availability Filter",
"description": "Let shoppers filter products by availability.",
"category": "woocommerce",
"keywords": [ "WooCommerce" ],
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/taxonomy-filter/block.json b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/taxonomy-filter/block.json
index 4fb63f1e637..773a611913f 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/taxonomy-filter/block.json
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/taxonomy-filter/block.json
@@ -2,7 +2,7 @@
"$schema": "https://schemas.wp.org/trunk/block.json",
"name": "woocommerce/product-filter-taxonomy",
"title": "Taxonomy Filter",
- "description": "Enable customers to filter the product collection by selecting one or more taxonomy terms, such as categories, brands, or tags.",
+ "description": "Let shoppers filter products by category, brand, or tag.",
"category": "woocommerce",
"keywords": [ "WooCommerce" ],
"textdomain": "woocommerce",
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/taxonomy-filter/index.tsx b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/taxonomy-filter/index.tsx
index aded94427e1..7d4ef036474 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/taxonomy-filter/index.tsx
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/taxonomy-filter/index.tsx
@@ -40,11 +40,8 @@ registerBlockType( metadata, {
),
description: sprintf(
// translators: %s is the taxonomy label.
- __(
- `Enable customers to filter the product collection by selecting one or more %s terms.`,
- 'woocommerce'
- ),
- item.label
+ __( 'Let shoppers filter products by %s.', 'woocommerce' ),
+ item.label.toLocaleLowerCase()
),
attributes: {
taxonomy: item.name,
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/taxonomy-filter/test/block.ts b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/taxonomy-filter/test/block.ts
index ac13ccdd6e7..260fa0df8e9 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/taxonomy-filter/test/block.ts
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/product-filters/inner-blocks/taxonomy-filter/test/block.ts
@@ -1,7 +1,7 @@
/**
* External dependencies
*/
-import type { BlockAttributes } from '@wordpress/blocks';
+import { type BlockAttributes } from '@wordpress/blocks';
import '@testing-library/jest-dom';
import { act, fireEvent, screen, within } from '@testing-library/react';