docs(SearchParams): Document that filter scores are supported in virtual replicas (#5716)

NixFrog · web-flow · commit 9ef126ccdc4a · 2026-01-23T10:10:05.000Z
diff --git a/specs/common/schemas/SearchParams.yml b/specs/common/schemas/SearchParams.yml
@@ -410,10 +410,10 @@ optionalFilters:
     Records that match the optional filter rank before records that don't match.
     If you're using a negative filter `facet:-value`, matching records rank after records that don't match.
 
-    - Optional filters don't work on virtual replicas.
     - Optional filters are applied _after_ sort-by attributes.
     - Optional filters are applied _before_ custom ranking attributes (in the default [ranking](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria)).
     - Optional filters don't work with numeric attributes.
+    - On virtual replicas, optional filters are applied _after_ the replica's [relevant sort](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/in-depth/relevant-sort).
 
   example: ['category:Book', 'author:John Doe']
   oneOf:
