diff --git a/lib/algolia/models/recommend/optional_filters.rb b/lib/algolia/models/recommend/optional_filters.rb
index 88ceb1d4..c67fc5f8 100644
--- a/lib/algolia/models/recommend/optional_filters.rb
+++ b/lib/algolia/models/recommend/optional_filters.rb
@@ -5,7 +5,7 @@
 
 module Algolia
   module Recommend
-    # Filters to promote or demote records in the search results.  Optional filters work like facet filters, but they don't exclude records from the search results. 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 don't work with numeric attributes.
+    # Filters to promote or demote records in the search results.  Optional filters work like facet filters, but they don't exclude records from the search results. 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.
     module OptionalFilters
       class << self
       # List of class defined in oneOf (OpenAPI v3)
diff --git a/lib/algolia/models/search/optional_filters.rb b/lib/algolia/models/search/optional_filters.rb
index 9865c5b8..96f2af71 100644
--- a/lib/algolia/models/search/optional_filters.rb
+++ b/lib/algolia/models/search/optional_filters.rb
@@ -5,7 +5,7 @@
 
 module Algolia
   module Search
-    # Filters to promote or demote records in the search results.  Optional filters work like facet filters, but they don't exclude records from the search results. 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 don't work with numeric attributes.
+    # Filters to promote or demote records in the search results.  Optional filters work like facet filters, but they don't exclude records from the search results. 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.
     module OptionalFilters
       class << self
       # List of class defined in oneOf (OpenAPI v3)