diff --git a/web/spec/supabase.yml b/web/spec/supabase.yml
index ab93d7f9ac9..4750cf1c246 100644
--- a/web/spec/supabase.yml
+++ b/web/spec/supabase.yml
@@ -1162,6 +1162,34 @@ pages:
       Filters can be used on `select()`, `update()`, and `delete()` queries. 
 
       If a Stored Procedure returns a table response, you can also apply filters.
+      
+      ### Applying Filters
+
+      You must apply your filters to the end of your query. For example:
+      
+      ```js
+      const { data, error } = await supabase
+        .from('cities')
+        .select('name, country_id')
+        .eq('name', 'The Shire')    // Correct
+
+      const { data, error } = await supabase
+        .from('cities')
+        .eq('name', 'The Shire')    // Incorrect
+        .select('name, country_id')
+      ```
+      
+      ### Chaining
+
+      Filters can be chained together to produce advanced queries. For example:
+
+      ```js
+      const { data, error } = await supabase
+        .from('cities')
+        .select('name, country_id')
+        .gte('population', 1000)
+        .lt('population', 10000)
+      ```
 
   .filter():
     $ref: '@supabase/postgrest-js."lib/PostgrestFilterBuilder".PostgrestFilterBuilder.filter'