diff --git a/algoliasearch/src/main/java/com/algolia/model/recommend/OptionalFilters.java b/algoliasearch/src/main/java/com/algolia/model/recommend/OptionalFilters.java
index 6ad85ec2..6bf00334 100644
--- a/algoliasearch/src/main/java/com/algolia/model/recommend/OptionalFilters.java
+++ b/algoliasearch/src/main/java/com/algolia/model/recommend/OptionalFilters.java
@@ -18,8 +18,10 @@
  * 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.
+ * 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.
  */
 @JsonDeserialize(using = OptionalFilters.Deserializer.class)
 public interface OptionalFilters {
diff --git a/algoliasearch/src/main/java/com/algolia/model/search/OptionalFilters.java b/algoliasearch/src/main/java/com/algolia/model/search/OptionalFilters.java
index 709d077e..04907c7a 100644
--- a/algoliasearch/src/main/java/com/algolia/model/search/OptionalFilters.java
+++ b/algoliasearch/src/main/java/com/algolia/model/search/OptionalFilters.java
@@ -18,8 +18,10 @@
  * 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.
+ * 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.
  */
 @JsonDeserialize(using = OptionalFilters.Deserializer.class)
 public interface OptionalFilters {