> For the complete documentation index, see [llms.txt](https://kb.mago.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.mago.io/mago-stage/admin-portal/invite-and-manage-users.md).

# Invite and manage users

The Company Users page is used to invite users and manage their access to the selected organization.

You need the appropriate user-management permission to perform these actions.

### View organization users

1. Sign in to the Administration Portal.
2. Confirm that the correct organization is selected.
3. Open the user menu.
4. Select **Profile**.
5. Select **Company Users**.

The user list can show:

* Name
* Email address
* Administrative roles
* Account status
* Location

Use the search field to find a user.

### Invite a user

1. Open **Profile > Company Users**.
2. Select **Invite User**.
3. Enter the user’s first name.
4. Enter the user’s last name.
5. Enter the user’s email address.
6. Optionally enter a nickname.
7. Select the required organization.
8. Assign the appropriate administrative role or roles.
9. Select **Create Invite**.

Leave the administrative role field empty when the user does not require Administration Portal access.

The user must follow the invitation instructions and create their initial password before signing in.

<figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2FCE90Xgm3vVKHai7nQbxN%2Fimage.png?alt=media&amp;token=3df4cde6-4f9a-496c-ac98-57d315f5e197" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Assign only the permissions required for the user’s responsibilities. For role definitions, see **Roles and permissions**.
{% endhint %}

### Edit a user

1. Open **Profile > Company Users**.
2. Find the required user.
3. Open the user actions menu.
4. Select **Edit**.
5. Update the permitted profile fields or administrative roles.
6. Select **Save Changes**.

Role changes affect which Administration Portal areas and actions are available to the user.

### View and revoke sessions

1. Find the required user.
2. Open the user actions menu.
3. Select **View Sessions**.
4. Review the user’s active and inactive sessions.
5. Revoke an individual session when required.

Use the option to revoke all active sessions when the user must be signed out from every device.

Revoking a session requires the user to sign in again on that device.

### Reset a user’s password

1. Find the required user.
2. Open the user actions menu.
3. Select **Reset Password**.
4. Confirm the action.

The user must follow the password-reset process before regaining normal access.

Use a password reset when an account might be compromised or when the user cannot access the account using the existing password.

### Disable a user

1. Find the required user.
2. Open the user actions menu.
3. Select **Disable**.
4. Confirm the action.

Disabling a user prevents further access and revokes the user’s active sessions.

Use this option for temporary access suspension.

### Reactivate a user

1. Find the disabled user.
2. Open the user actions menu.
3. Select the option to reactivate or enable the account.
4. Confirm the action.

Reactivating an account restores the ability to sign in. It does not restore a previously revoked session.

### Delete a user

1. Find the required user.
2. Open the user actions menu.
3. Select **Delete**.
4. Review the confirmation.
5. Confirm the deletion.

{% hint style="danger" %}
User deletion is intended for permanent removal. Use **Disable** when access might need to be restored later.
{% endhint %}

Before deleting a user:

* Confirm that the user no longer requires access.
* Transfer any administrative responsibilities.
* Review access to shared Mago Remote Agents.
* Check applicable data-retention requirements.
* Confirm that another authorized administrator remains available.
