diff --git a/docs-devsite/auth.md b/docs-devsite/auth.md
index f0f9029c225..d53b53b3b27 100644
--- a/docs-devsite/auth.md
+++ b/docs-devsite/auth.md
@@ -532,7 +532,7 @@ export declare function onAuthStateChanged(auth: Auth, nextOrObserver: NextOrObs
 
 Adds an observer for changes to the signed-in user's ID token.
 
-This includes sign-in, sign-out, and token refresh events.
+This includes sign-in, sign-out, and token refresh events. This will not be triggered automatically upon ID token expiration. Use [User.getIdToken()](./auth.user.md#usergetidtoken) to refresh the ID token.
 
 <b>Signature:</b>
 
diff --git a/packages/auth/src/core/index.ts b/packages/auth/src/core/index.ts
index f324a13ae9a..ec551f9510c 100644
--- a/packages/auth/src/core/index.ts
+++ b/packages/auth/src/core/index.ts
@@ -65,6 +65,7 @@ export function setPersistence(
  *
  * @remarks
  * This includes sign-in, sign-out, and token refresh events.
+ * This will not be triggered automatically upon ID token expiration. Use {@link User.getIdToken} to refresh the ID token.
  *
  * @param auth - The {@link Auth} instance.
  * @param nextOrObserver - callback triggered on change.