Skip to main content

Share sessions across sub domains

Sharing sessions across multiple sub domains in SuperTokens can be configured by setting the sessionScope attribute of the Session recipe in your frontend code.

Example:

  • Your app has two subdomains abc.example.com and xyz.example.com. We assume that the user logs in via example.com
  • To enable sharing sessions across example.com, abc.example.com and xyz.example.com the sessionsScope attribute must be set to .example.com
import SuperTokens from "supertokens-auth-react";import Session from "supertokens-auth-react/recipe/session";
SuperTokens.init({    appInfo: {        // ...        // this should be equal to the domain where the user will see the login UI        apiDomain: "...",        appName: "...",        websiteDomain: "https://example.com"    },    recipeList: [        Session.init({            sessionScope: ".example.com"        })    ]});
caution

Do not set sessionScope to a value that's in the public suffix list (Search for your value without the leading dot). Otherwise session management will not work.