diff --git a/packages/gotrue/lib/src/gotrue_client.dart b/packages/gotrue/lib/src/gotrue_client.dart
index 44981749..543560b0 100644
--- a/packages/gotrue/lib/src/gotrue_client.dart
+++ b/packages/gotrue/lib/src/gotrue_client.dart
@@ -387,6 +387,8 @@ class GoTrueClient {
   ///
   /// [captchaToken] is the verification token received when the user
   /// completes the captcha on the app.
+  /// Note: Supported providers for signInWithIdToken are Google, Apple, Kakao, Keycloak. Facebook is NOT supported (see issue #1259 and OAuthProvider enum for details).
+
   Future<AuthResponse> signInWithIdToken({
     required OAuthProvider provider,
     required String idToken,