diff --git a/web/spec/supabase.yml b/web/spec/supabase.yml
index 11febbbf335..a5a240e6d68 100644
--- a/web/spec/supabase.yml
+++ b/web/spec/supabase.yml
@@ -257,7 +257,7 @@ pages:
           ```
       - name: Sign up with scopes.
         description: |
-          If you need additional data from an OAuth provider, you can include a space-separated list of scopes in your request.
+          If you need additional data from an OAuth provider, you can include a space-separated list of scopes in your request to get back an OAuth provider token.
           You may also need to specify the scopes in the provider's OAuth app settings, depending on the provider.
         js: |
           ```js
@@ -337,7 +337,7 @@ pages:
           ```
       - name: Sign in with scopes.
         description: |
-          If you need additional data from an OAuth provider, you can include a space-separated list of scopes in your request.
+          If you need additional data from an OAuth provider, you can include a space-separated list of scopes in your request to get back an OAuth provider token.
           You may also need to specify the scopes in the provider's OAuth app settings, depending on the provider.
         js: |
           ```js