diff --git a/apps/console/src/pages/organizations/cookie-banners/configuration/cookies/_components/CategorySection.tsx b/apps/console/src/pages/organizations/cookie-banners/configuration/cookies/_components/CategorySection.tsx
index 28f749eba..2078f50e3 100644
--- a/apps/console/src/pages/organizations/cookie-banners/configuration/cookies/_components/CategorySection.tsx
+++ b/apps/console/src/pages/organizations/cookie-banners/configuration/cookies/_components/CategorySection.tsx
@@ -59,7 +59,7 @@ export const categorySectionFragment = graphql`
     description
     kind
     cookies(first: 100, orderBy: { field: CREATED_AT, direction: ASC })
-      @connection(key: "CategorySection_cookies")
+      @connection(key: "CategorySection_cookies", filters: [])
       @required(action: THROW) {
       __id
       edges {
diff --git a/contrib/claude/relay.md b/contrib/claude/relay.md
index bf9e5cd69..3e3f0cc98 100644
--- a/contrib/claude/relay.md
+++ b/contrib/claude/relay.md
@@ -348,7 +348,7 @@ const fragment = graphql`
   fragment CategorySectionFragment on CookieCategory {
     id
     cookies(first: 100, orderBy: { field: CREATED_AT, direction: ASC })
-      @connection(key: "CategorySection_cookies")
+      @connection(key: "CategorySection_cookies", filters: [])
       @required(action: THROW) {
       __id
       edges {
@@ -365,6 +365,38 @@ const category = useFragment(fragment, categoryKey);
 const connectionId = category.cookies.__id;
 ```
 
+#### `filters` on `@connection`
+
+By default Relay treats every non-pagination argument (`first`, `last`, `after`, `before` are excluded) as a **filter** and encodes its value into the connection's store identity. This means `ConnectionHandler.getConnection(record, key)` will fail to find the connection unless the exact same filter values are passed as a third argument.
+
+**Use `filters: []`** when the connection has fixed arguments (e.g. a hardcoded `orderBy`) and there is only ever one instance of the connection per parent node. This is the common case — it keeps `ConnectionHandler.getConnection` and `getConnectionID` simple:
+
+```graphql
+# Good — single fixed ordering, no filtered variants
+cookies(first: 100, orderBy: { field: CREATED_AT, direction: ASC })
+  @connection(key: "CategorySection_cookies", filters: [])
+```
+
+**List specific filter arguments** when the same connection is rendered with different filter values and you need Relay to maintain separate lists in the store (e.g. a table with user-selectable sorting or status filters):
+
+```graphql
+# Good — user can change the status filter, each variant is a separate list
+tasks(first: 50, status: $status, orderBy: $order)
+  @connection(key: "TaskList_tasks", filters: ["status"])
+```
+
+When `filters` includes an argument, `ConnectionHandler.getConnection` requires matching filter values:
+
+```tsx
+const conn = ConnectionHandler.getConnection(record, "TaskList_tasks", {
+  status: "OPEN",
+});
+```
+
+**Never omit `filters`** — rely on the explicit list rather than Relay's default (all non-pagination args), which silently breaks `ConnectionHandler` lookups and `updater` functions.
+
+#### Connection ID from outside the subtree
+
 When the mutation is triggered from a component that doesn't have access to the connection's `__id` (e.g. a sibling's child rather than a direct descendant), derive the connection ID with `ConnectionHandler.getConnectionID`:
 
 ```tsx