diff --git a/apps/reference/_supabase_js/generated/subscribe.mdx b/apps/reference/_supabase_js/generated/subscribe.mdx
index 46a10c22980..afe626e5e17 100644
--- a/apps/reference/_supabase_js/generated/subscribe.mdx
+++ b/apps/reference/_supabase_js/generated/subscribe.mdx
@@ -89,6 +89,7 @@ No description provided.
 - Row level security is not applied to delete statements.
 - 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;`
 - When a delete occurs, the contents of old_record will be broadcast to all subscribers to that table so ensure that each table's replica identity only contains information that is safe to expose publicly.
+- The channel name must exactly match the schema/table/filter you want to listen to separated by semicolons. See below examples for additional context.
 
 ## Examples
 
diff --git a/spec/supabase_js_v2_legacy.yml b/spec/supabase_js_v2_legacy.yml
index ee7779ad29e..cfe9d171435 100644
--- a/spec/supabase_js_v2_legacy.yml
+++ b/spec/supabase_js_v2_legacy.yml
@@ -1156,6 +1156,7 @@ pages:
       - Row level security is not applied to delete statements.
       - 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;`
       - When a delete occurs, the contents of old_record will be broadcast to all subscribers to that table so ensure that each table's replica identity only contains information that is safe to expose publicly.
+      - The channel name must exactly match the schema/table/filter you want to listen to separated by semicolons. See below examples for additional context.
     examples:
       - name: Listen to all database changes
         isSpotlight: true