ContextQMD
Back to Medusa

{metadata.title}

www/apps/user-guide/app/settings/profile/page.mdx

2.16.04.7 KB
Original Source

import { EllipsisHorizontal } from "@medusajs/icons"

export const metadata = { title: Manage Profile in Medusa Admin, }

{metadata.title}

In this guide, you’ll learn how to view and manage your profile's details and settings.

View Profile Details

To view your profile details, go to Settings → Profile. You can alternatively click on your name at the bottom of the sidebar, and choose "Profile settings" from the menu.

In your profile details page, you can view your profile information such as your name, email, and language settings. You can also manage your two-factor authentication settings.

Edit Profile Details

To edit your profile details and settings:

  1. Go to Settings → Profile.
  2. Click the <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon in the main section's header.
  3. Choose "Edit" from the dropdown.
  4. In the side window that opens, you can edit your first and last name, and the Medusa Admin dashboard language. This only changes the language of the admin interface, not the language of the store. It also doesn't change the language for other users in the admin.
  5. Once you're done, click the Save button.
<Note title="Tip">

Can't find your language? Learn how you can contribute by translating the admin to other languages here.

</Note>

Manage Two-Factor Authentication

<Note>

Two-factor authentication is available from Medusa Admin v2.15.5. If you don't see the Two-Factor Authentication option in your Medusa Admin, request your technical team to upgrade your Medusa application.

</Note>

You can enable two-factor authentication (2FA) for your account to add an extra layer of security. With 2FA enabled, you'll need to provide a verification code from an authentication app (like Google Authenticator) in addition to your password when logging in.

View Two-Factor Authentication Status

To view the status of two-factor authentication for your account:

  1. Go to Settings → Profile.
  2. In the "Two-Factor Authentication" section, you can see next to the "Status" row either "Enabled" or "Disabled" depending on whether 2FA is enabled for your account or not.

Enable Two-Factor Authentication

To enable two-factor authentication:

  1. Go to Settings → Profile.
  2. In the "Two-Factor Authentication" section, click the Enable or Disable button depending at the top end of the section, depending on the current status of 2FA in your account.
  3. In the pop-up that opens, either scan the QR code using your authentication app or enter the secret key above the QR code into your authentication app.
  4. Copy the 6-digit code generated by your authentication app and enter it in the input field in the pop-up.
  5. Before confirming, you can optionally download or copy the recovery codes. These codes can be used to access your account if you lose access to your authentication app.
  6. Once done, click the Complete button.

Disable Two-Factor Authentication

To disable two-factor authentication, click the Disable button at the top end of the "Two-Factor Authentication" section.

Based on your application's configuration, you may need to enter a verification code from your authentication app to confirm disabling 2FA. If prompted, open your authentication app, get the 6-digit code for your Medusa Admin account, and enter it in the input field.

Login with Two-Factor Authentication

The next time you log in to your Medusa Admin account, after entering your email and password, you'll be prompted to enter a verification code from your authentication app. Open your authentication app, get the 6-digit code for your Medusa Admin account, and enter it in the input field to complete the login process.

Login with Recovery Codes

If you lose access to your authentication app, you can use one of the recovery codes you saved when enabling 2FA to log in.

After entering your email and password on the login page:

  1. Click on the "Use a recovery code" link.
  2. Enter one of your recovery codes in the input field. If you copied all the recovery codes, paste one of them in the input field.
  3. Click the "Verify" button to log in.
<Note type="warning">

Each recovery code can only be used once. If you use a recovery code to log in, and you don't have any unused recovery code left or access to your authentication app, go to your profile and disable two-factor authentication then enable it to repeat the setup and get new recovery codes.

</Note>