Commit 583d67b8eca for woocommerce
commit 583d67b8eca72bb6c0376c5a30cfb15d96b95521
Author: Tung Du <dinhtungdu@gmail.com>
Date: Tue Jun 16 00:32:32 2026 +0700
Clarify Product Filters store visibility (#65745)
docs: clarify product filters store visibility
diff --git a/AGENTS.md b/AGENTS.md
index c2436fcfd24..dc8f487ce94 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -153,13 +153,15 @@ For detailed test commands, see `woocommerce-dev-cycle` skill.
## Interactivity API Stores
-All WooCommerce Interactivity API stores are **private by design**:
+Most WooCommerce Interactivity API stores are **private by design**. Exception: the `woocommerce/product-filters` store is public for Product Filters inner-block extensibility.
-- Stores use `lock: true` indicating they are not intended for extension
+For private stores:
+
+- Not intended for third-party extension
- Removing or changing store state/selectors is **not a breaking change**
- No backwards compatibility is required for store internals
-- If a store needs to be extensible in the future, it will be split into private (internal) and public (API) stores
-- General stores (namespace `woocommerce`) may become public eventually, but currently all are locked
+- If another store needs to be extensible in the future, it will be split into private (internal) and public (API) stores
+- General stores (namespace `woocommerce`) may become public eventually, but currently remain private
Reference: [WordPress Interactivity API - Private Stores](https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/api-reference#private-stores)
diff --git a/plugins/woocommerce/client/blocks/CLAUDE.md b/plugins/woocommerce/client/blocks/CLAUDE.md
index e2784f3788a..063cbbc047e 100644
--- a/plugins/woocommerce/client/blocks/CLAUDE.md
+++ b/plugins/woocommerce/client/blocks/CLAUDE.md
@@ -132,9 +132,11 @@ $this->asset_data_registry->add('reviewRatingsEnabled', wc_review_ratings_enable
// Available in JS as window.wcSettings.reviewRatingsEnabled
```
-### Interactivity API Stores (LOCKED)
+### Interactivity API Stores
-All WooCommerce Interactivity API stores use `lock: true`. They are **private by design**:
+Most WooCommerce Interactivity API stores are private by design. Exception: the `woocommerce/product-filters` store is public for Product Filters inner-block extensibility.
+
+For private stores:
- Not intended for third-party extension
- Removing/changing store state is NOT a breaking change