Account Link

The Account Link extension prompts users that may have created a second account by mistake to link the new account with their old one on their first login. The user may choose to either link the two accounts or keep them separate if it was intentional.

Install the Extension

To install this extension, click on the Account Link box in the list of provided extensions on the Extensions page of the dashboard. The Install Extension window will open.

Install Account Link Extension

The extension will create a new Client named auth0-account-link to use internally and a new Rule to redirect users to the extension if they login with a new account that has an email matching an existing account.

Setup

Changing the Client Name

We recommend changing the default client used for the extension to something descriptive and easy to read for your customers, like Account Linking, since it will appear on the Hosted Login Page when they authenticate their primary account.

Updating the Hosted Login Page

By default, Auth0's Hosted Login Page allows a user to sign up as one may expect. However, when the account linking asks you to authenticate your primary account in order to link it with the new account, providing a sign up option is confusing for users and could leave them in an unexpected state.

To prevent this, we send over a query parameter to let the Hosted Login Page know that it should hide the Sign Up option. In order for this query parameter to take effect, however, we must first customize the Hosted Login Page.

First go to your dashboard and click on Hosted Pages. It should open to the Login Page by default.

If it is not already enabled, toggle the Customize Login Page to enable the custom editor below. In the editor we're going to add a new line to the Lock config.

Toward the bottom of the object configuring the Lock widget, add the following line (after the closable setting works well):

allowSignUp: !config.extraParams.prevent_sign_up,

Updating the Hosted Page

Then save your changes and attempt to link an account. You'll notice that the Sign Up option is no longer present and your users are safe from an extra level of confusion.

Account Linking Hosted Page

Customization

At installation, or any time after by clicking the Settings icon for the Account Link Extension, you can add a URL to a custom stylesheet if you would like to customize the extension page to look a bit different from the default theme.

Account Linking Page