diff --git a/web/spec/supabase.yml b/web/spec/supabase.yml
index 926dacefe8c..64eebd15940 100644
--- a/web/spec/supabase.yml
+++ b/web/spec/supabase.yml
@@ -688,6 +688,7 @@ pages:
     title: 'on().subscribe()'
     $ref: '@supabase/supabase-js."lib/SupabaseQueryBuilder".SupabaseQueryBuilder.on'
     notes: |
+      - Realtime is disabled by default for new Projects for better database performance and security. You can turn it on by [managing replication](/docs/guides/api#managing-realtime).
       - If you want to receive the "previous" data for updates and deletes, you will need to set `REPLICA IDENTITY` to `FULL`, like this: `ALTER TABLE your_table REPLICA IDENTITY FULL;`
     examples:
       - name: Listen to all database changes