> ## Documentation Index
> Fetch the complete documentation index at: https://docs.relayhub.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Users

> Add, edit, and manage users in your RelayHub instance

The **User Hub** is your central dashboard for managing every user in your RelayHub instance. From here, admins can view the full user roster, modify roles, reset passwords, adjust permissions, and remove accounts.

## Accessing the User Hub

Navigate to **User Hub** in the left sidebar. The User Hub is only visible to users with the **Admin** role.

You will see a searchable table of all users with their name, email, role, status, and last login date.

## Editing a User

<Steps>
  <Step title="Select the user">
    Click on any user row in the table to open their profile panel.
  </Step>

  <Step title="Modify fields">
    Update the user's name, email, role, or any of the feature-level permission flags. See [Roles & Permissions](/administration/user-management/permissions) for details on each flag.
  </Step>

  <Step title="Save changes">
    Click **Save** to apply. Changes take effect immediately -- the user does not need to log out and back in.
  </Step>
</Steps>

## Resetting a User's Password

<Steps>
  <Step title="Open the user profile">
    Click the user row in the User Hub table.
  </Step>

  <Step title="Click Reset Password">
    In the user detail panel, click the **Reset Password** button. A confirmation dialog will appear.
  </Step>

  <Step title="Confirm the reset">
    The user will receive an email with a secure link to set a new password. The link expires after 24 hours.
  </Step>
</Steps>

<Note>
  Password reset emails are sent through your configured email provider. Ensure your instance has valid SMTP or email service credentials.
</Note>

## Changing a User's Role

Toggle a user between **Admin** and **Member** roles from their profile panel. Admins have full access to all management features (User Hub, Provider Hub, billing, settings). Members have access only to chat, workspaces, and features enabled by their permission flags.

<Warning>
  Every instance must have at least one Admin. RelayHub will prevent you from demoting the last remaining Admin.
</Warning>

## Deleting a User

<Steps>
  <Step title="Open the user profile">
    Click the user row in the User Hub table.
  </Step>

  <Step title="Click Delete User">
    Scroll to the bottom of the profile panel and click **Delete User**.
  </Step>

  <Step title="Confirm deletion">
    A confirmation dialog will warn you that this action is permanent. The user's account, chat history ownership, and workspace memberships will be removed.
  </Step>
</Steps>

<Warning>
  Deleting a user is irreversible. Conversations they participated in will remain in shared workspaces, but their individual chats and files will be permanently deleted.
</Warning>

## User Status

Users can be in one of the following states:

| Status       | Meaning                                             |
| ------------ | --------------------------------------------------- |
| **Active**   | User can log in and use the platform normally       |
| **Invited**  | Invitation sent but not yet accepted                |
| **Disabled** | Account suspended by an admin -- user cannot log in |

<Tip>
  Use the search bar at the top of the User Hub to quickly filter users by name, email, or role.
</Tip>