Self-Service Account Management
On this page
This feature requires at least a Starter plan.
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.
Account Troubleshooting
Learn about troubleshooting steps for Self Service Account Registration.
Add Authenticator as a Second Factor
Learn how users add an authenticator app as a second factor on the self-service account pages.
Add Email as a Second Factor
Learn how users add email as a second factor on the self-service account pages.
Add Phone as a Second Factor
Learn how users add a phone as a second factor on the self-service account pages.
Add WebAuthn Passkey
Learn how to add a WebAuthn passkey.
Bootstrapping Login For Self-Service Account Management
How to allow users to access self-service account management from external applications.
Customizing Self-Service Account Management
Learn how to add fields to the self-service account management pages and change the account page templates.
Update User Profiles and Passwords
Learn how users update their profile data and change their passwords on the self-service account pages.
The following video shows the account pages:
Open the Self-Service Pages#
Each Application has an Account URL. To find the Account URL:
-
Navigate to Applications and click on the Application.
-
Copy 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 since1.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:/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.

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 two-factor page lists the user's MFA methods and lets the user add a method.

FusionAuth supports the following MFA methods:
- Authenticator app
- SMS, with optional voice delivery in
1.65.0and later
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.

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.
Related
Learn how to add a WebAuthn passkey.
How to allow users to access self-service account management from external applications.
Learn how to add fields to the self-service account management pages and change the account page templates.
Learn how to register, verify, manage, and provision users in FusionAuth.