diff --git a/apps/docs/pages/guides/auth/social-login/auth-slack.mdx b/apps/docs/pages/guides/auth/social-login/auth-slack.mdx
index 2f9539d049d..8af70ee2779 100644
--- a/apps/docs/pages/guides/auth/social-login/auth-slack.mdx
+++ b/apps/docs/pages/guides/auth/social-login/auth-slack.mdx
@@ -10,6 +10,12 @@ To enable Slack Auth for your project, you need to set up a Slack OAuth applicat
 
 ## Overview
 
+<Admonition type="caution" label="update">
+
+The Slack OAuth provider supported by Supabase uses Slack's [**Legacy OAuth API**](https://api.slack.com/legacy/oauth). If you created an OAuth app on Slack recently, some of the scopes specified may not work with the Slack OAuth provider on Supabase. You can refer to the [**list of supported scopes**](https://api.slack.com/scopes) for the legacy OAuth app and this [**github issue**](https://github.com/supabase/gotrue/issues/1294) for future updates.
+
+</Admonition>
+
 Setting up Slack logins for your application consists of 3 parts:
 
 - Create and configure a Slack Project and App on the [Slack Developer Dashboard](https://api.slack.com/apps).