Self-Service Account Management

On this page
Starter plan required

This feature requires at least a Starter plan.

Available since 1.26.0

The self-service account pages let users manage their own accounts. A user can update profile data, change a password, and add or remove MFA methods. FusionAuth hosts the account pages.

The following video shows the account pages:

Play

Open the Self-Service Pages#

Each Application has an Account URL. To find the Account URL:

  1. Navigate to Applications and click on the Application.

  2. Copy the Account URL.

    The application details dialog showing the Account URL.

The Account URL has the following format:

https://<your-fusionauth-host>/account/?client_id=<client-id>

In your application, link to the Account URL from your navigation.

The account pages are separate from the Admin UI. The Manage page for a user in the Admin UI shows the admin view, not the account pages. To test the account pages, open the Account URL in a private window or a different browser. A private window keeps your admin session out of the way.

Return to Your Application#

Available since 1.69.0

The account pages show a Return to application link at the top of the page. By default, the link points to the Referer header of the request that opened the account pages. To set the return link, add the redirect_uri query parameter to the Account URL:

https://example.com/account/?client_id=<client_id>&redirect_uri=https://your-app.example.com

When a user opens the account pages from the Admin UI, the account pages show no return link.

Log In to the Account Pages#

FusionAuth asks the user to log in before showing the account pages. The user must be registered for the Application.

Update User Data and Password#

To change profile data or a password, the user clicks Edit profile on the account page. The edit page shows the form fields and a Change password toggle.

The account edit form with Change password switched on.

For more information, see Updating User Data and Password. To add fields to the form, see Customizing Self-Service Account Management.

Enable or Disable MFA#

To manage MFA methods, the user clicks Manage two-factor on the account page.

The account page with the edit button and the two-factor and passkey links.

The two-factor page lists the user's MFA methods and lets the user add a method.

The two-factor page with no methods configured.

FusionAuth supports the following MFA methods:

When the account pages show a warning instead, the tenant or the Application needs more configuration. For more information, see Troubleshooting.

Recovery Codes#

When a user adds a first MFA method, FusionAuth shows a set of recovery codesA code used to regain access to an account when the user loses their multi-factor authentication factors.. Tell users to store the recovery codes in a safe place. A user who loses access to every MFA method, such as after losing a phone, can log in with a recovery code.

The recovery codes shown after two-factor authentication is enabled.

Log Out of the Account Pages#

The account pages have a separate session from the FusionAuth SSO session and from your application session. When a user logs out of your application, the account session stays active. On a shared computer, the next person can then open the account pages as that user.

To end the account session, redirect the user to the account logout endpoint with the Application's client Id:

https://<your-fusionauth-host>/account/logout?client_id=<client-id>

To follow the work on ending both sessions together, see GitHub issue 2298.