diff --git a/src/routes/docs/products/auth/oauth2/+page.markdoc b/src/routes/docs/products/auth/oauth2/+page.markdoc index fcbd4566ff..e3f97789b6 100644 --- a/src/routes/docs/products/auth/oauth2/+page.markdoc +++ b/src/routes/docs/products/auth/oauth2/+page.markdoc @@ -28,6 +28,10 @@ Before using OAuth 2 login, you need to enable and configure an OAuth 2 login pr To initialize the OAuth 2 login process, use the [Create OAuth 2 Session](/docs/references/cloud/client-web/account#createOAuth2Session) route. +{% info title="Third‑Party cookies" %} +Most browsers now block third‑party cookies by default, so `createOAuth2Session` may not set a session. Use the [token‑based flow](/docs/products/auth/server-side-rendering#oauth2) instead or set up a custom domain in Appwrite that matches your app’s origin so cookies are first‑party. Learn more here: [Fixing OAuth2 issues in Appwrite Cloud](/blog/post/fixing-oauth2-issues-in-appwrite-cloud). +{% /info %} + OAuth2 sessions allow you to specify the scope of the access you want to request from the OAuth2 provider. The requested scopes describe which resources a session can access. @@ -395,4 +399,4 @@ val response = account.updateSession( {% info title="GraphQL" %} OAuth 2 is not available through the GraphQL API. You can use the REST API or any Client SDK instead. -{% /info %} \ No newline at end of file +{% /info %}