ContextQMD
Back to Medusa

{metadata.title}

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

2.20.14.1 KB
Original Source

import { EllipsisHorizontal, ArrowUpRightOnBox, EllipsisVertical } from "@medusajs/icons"

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

{metadata.title}

In this guide, you’ll learn how to manage users in your store.

<Note title="Tip">

You can't create a user. Instead, you need to invite them to join your store.

</Note>

View Users

You can view admin users by going to Settings → Users. In the list, you can see user details such as the name and email. You can also search, filter, and sort the users to find the specific item you are looking for.

View User Details

To view the details of a user:

  1. Go to Settings → Users.
  2. Click on the user in the list.

This opens the user's details page where you can also manage the user.

Edit a User’s Details

To edit the details of an admin user:

  1. Go to the user's details page.
  2. Click the <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon in the first section's header.
  3. Choose Edit from the dropdown.
  4. In the side window that opens, you can edit the user's first and last names.
  5. Once done, click the Save button.

Manage User Metadata

Metadata is custom data that can be associated with the user in key-value pairs. This is usually used by developers for custom integrations or to store additional information about the user.

To edit the user's metadata:

  1. Click the <InlineIcon Icon={ArrowUpRightOnBox} alt="arrow" /> icon in the "Metadata" section.
  2. In the side window that opens:
    • Manage the key-value pairs in the table.
    • To add a new row of key-value pairs before or after a row:
      • Hover over the row and click the <InlineIcon Icon={EllipsisVertical} alt="three-dots" /> icon at its end.
      • Choose "Insert row above" or "Insert row below" from the dropdown.
    • To delete a row of key-value pairs:
      • Hover over the row and click the <InlineIcon Icon={EllipsisVertical} alt="three-dots" /> icon at its end.
      • Choose "Delete row" from the dropdown.
  3. Once you're done, click the Save button.

If a user authenticates with an email and password, you can generate and copy a reset password link for them. This is useful when you want to share the link directly without sending an email.

<Note>

This feature is available since Medusa v2.20.0. The option only appears for users that authenticate with an email and password. If you don't find the option to copy a reset password link, make sure to update your Medusa application.

</Note>

To copy the reset password link for a user:

  1. Go to the user's details page.
  2. Click the <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon in the first section's header.
  3. Choose "Copy reset password link" from the dropdown.

The link is copied to your clipboard. The link expires shortly and invalidates any reset password link previously sent to this user.

Delete a User

<Note>

This feature is available since Medusa v2.12.0. If you don't find the option to delete a user, or user deletion doesn't work, make sure to update your Medusa application.

</Note> <Note type="warning">

Deleting a user is irreversible.

</Note>

To delete a user from your store:

  1. Go to Settings → Users.
  2. Find the user in the list and click on it.
  3. Click the <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon in the first section's header.
  4. Choose Delete from the dropdown.
  5. Confirm deleting the user by entering their name and clicking the "Delete" button in the pop-up.