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

# User management

> Create, manage, and administer user accounts

User management is performed by global administrators through the Global Settings section of the management console. From here, you can create accounts, reset passwords, grant administrator privileges, and manage user lifecycle.

<Note>
  All operations on this page require **Global Administrator** privileges.
</Note>

## Accessing user management

Navigate to **Global Settings** from the user menu in the top-right corner. The Members page displays all users in the system with their current state.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/mistriveinc/slWkJzGyi9iUbnCy/images/users-light.png?fit=max&auto=format&n=slWkJzGyi9iUbnCy&q=85&s=f784ad99db7b1093d1ff1cb813074d3e" alt="Global Settings Members page in light mode" width="3098" height="1480" data-path="images/users-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/mistriveinc/slWkJzGyi9iUbnCy/images/users-dark.png?fit=max&auto=format&n=slWkJzGyi9iUbnCy&q=85&s=321ef96fe647922d8e6e2f55319b63de" alt="Global Settings Members page in dark mode" width="3098" height="1480" data-path="images/users-dark.png" />
</Frame>

## Creating user accounts

<Steps>
  <Step title="Open the create user form">
    Click **Create user** in the top-right corner of the Members page.
  </Step>

  <Step title="Enter account details">
    Provide the user's email address and set an initial password. Passwords must be at least 8 characters.
  </Step>

  <Step title="Add personal information (optional)">
    Optionally enter the user's given name and family name for display purposes.
  </Step>

  <Step title="Create the account">
    Click **Create user** to create the account. The user can now sign in with the provided credentials.
  </Step>
</Steps>

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/mistriveinc/slWkJzGyi9iUbnCy/images/create-user-light.png?fit=max&auto=format&n=slWkJzGyi9iUbnCy&q=85&s=54beefb880bd00eb6e5c3bbab2ee234c" alt="Create User form in light mode" width="970" height="2440" data-path="images/create-user-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/mistriveinc/slWkJzGyi9iUbnCy/images/create-user-dark.png?fit=max&auto=format&n=slWkJzGyi9iUbnCy&q=85&s=71a131ae16bf90be0bb6ecccb1aea609" alt="Create User form in dark mode" width="970" height="2440" data-path="images/create-user-dark.png" />
</Frame>

Share the initial password with the user through a secure channel. Users can change their own password after signing in through Account Settings.

## Managing an existing user

Click the edit icon next to any user to open their detail page. From here you can update personal information, change passwords, manage admin status, and control account state.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/mistriveinc/slWkJzGyi9iUbnCy/images/user-detail-light.png?fit=max&auto=format&n=slWkJzGyi9iUbnCy&q=85&s=90aea90fa107cfc58eafaabb1475c10e" alt="User detail page in light mode" width="2954" height="1304" data-path="images/user-detail-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/mistriveinc/slWkJzGyi9iUbnCy/images/user-detail-dark.png?fit=max&auto=format&n=slWkJzGyi9iUbnCy&q=85&s=3b8ebb1124ff42df27836db839599b4f" alt="User detail page in dark mode" width="2954" height="1304" data-path="images/user-detail-dark.png" />
</Frame>

### Changing a user's password

As an administrator, you can reset any user's password without knowing their current password.

<Steps>
  <Step title="Open the user detail page">
    Navigate to Global Settings and click the edit icon next to the user.
  </Step>

  <Step title="Click Update password">
    Click the **Update password** button in the actions area.
  </Step>

  <Step title="Enter the new password">
    Enter the new password twice to confirm. Passwords must be at least 8 characters.
  </Step>

  <Step title="Save the password">
    Click **Update password** to apply the change. The user's existing sessions remain active.
  </Step>
</Steps>

<Tip>
  Users can change their own password through **Account Settings** without administrator intervention. This requires knowing their current password.
</Tip>

### Making a user a global administrator

Global administrators have full access to manage all users, organizations, and platform settings.

<Steps>
  <Step title="Open the user detail page">
    Navigate to Global Settings and click the edit icon next to the user.
  </Step>

  <Step title="Grant administrator privileges">
    Click **Make global admin** in the actions area. The change takes effect immediately.
  </Step>
</Steps>

The user will see "Global admin" badge next to their name and gain access to Global Settings.

To remove administrator privileges, click **Remove global admin** on the same page.

<Warning>
  Ensure at least one global administrator account exists at all times. The system prevents removing admin privileges from the last remaining administrator.
</Warning>

### Scheduling a user for deletion

Deleting a user places their account in a deletion state rather than removing it immediately. This provides a grace period during which the account can be restored.

<Steps>
  <Step title="Open the user detail page">
    Navigate to Global Settings and click the edit icon next to the user.
  </Step>

  <Step title="Delete the user">
    Click **Delete user** and confirm the action. The account enters the "In deletion" state.
  </Step>
</Steps>

Users in the deletion state:

* Cannot sign in to the platform
* Retain their organization memberships and project access (frozen)
* Can be restored by an administrator

<Info>
  Actual deletion of user data is not yet implemented. Users will remain in the "In deletion" state indefinitely until deletion is implemented or they are restored.
</Info>

### Restoring a deleted user

Users scheduled for deletion can be restored to active status.

<Steps>
  <Step title="Open the user detail page">
    Navigate to Global Settings and find the user (they will show "In deletion" badge).
  </Step>

  <Step title="Restore the user">
    Click **Restore user** and confirm. The account returns to active status.
  </Step>
</Steps>

Restored users regain access to all their previous organization memberships and project permissions.

## User states

Users can be in one of three states:

| State           | Description                                                     |
| --------------- | --------------------------------------------------------------- |
| **Active**      | Normal operating state. User can sign in and access resources.  |
| **Disabled**    | Account is disabled. User cannot sign in but data is preserved. |
| **In deletion** | Scheduled for deletion. User cannot sign in. Can be restored.   |

## Self-service account settings

Users can manage certain aspects of their own account without administrator intervention:

* **Change password** — Users can change their own password through Account Settings (requires current password)
* **View organizations** — Users can see which organizations they belong to
* **Update personal information** — Users can update their own name and contact details

Access Account Settings from the user menu in the top-right corner of the management console.
