Skip to main content

If you are using our backend SDK that is lesser than the following versions, please visit the older documentation link here.

Which UI do you use?
Custom UI
Pre built UI

Password managers

Styling encapsulation relies on the "shadow DOM" browser feature.

Unfortunately, password managers such as Dashlane, LastPass, OnePassword, etc do not detect authentication forms fields inside shadow DOMs.

Therefore, if you would like to make sure that your end users can use their password managers, you will have to disable shadow DOM.

import SuperTokens from "supertokens-auth-react";

SuperTokens.init({
appInfo: {
apiDomain: "...",
appName: "...",
websiteDomain: "..."
},
useShadowDom: false,
recipeList: [ /* ... */]
});
Demo of a password manager working with prebuilt UI when shadow DOM is disabled
caution
  • SuperTokens uses a special attribute to define its styling so disabling shadow DOM should not impact the rest of your application's styles. On the other hand, when disabling Shadow DOM, make sure to verify that your CSS does not impact how SuperTokens UI is rendered.
  • Shadow DOM will always be disabled with Internet Explorer since it does not support it. Similarly, if you intend to support Internet Explorer for your application make sure to verify how SuperTokens UI is rendered.
Looking for older versions of the documentation?
Which UI do you use?
Custom UI
Pre built UI