# Managing Structural users

{% hint style="info" %}
**Required license:** Professional or Enterprise

**Required global permission:** Manage access to Tonic Structural and to any workspace
{% endhint %}

The **Access Management** tab on **Structural Settings** view includes a list of the current Tonic Structural users.

From the list, you can remove Structural users. You can also restore removed users. If you do not use SSO to manage users, then you can reset passwords for Structural users.

For information on how users are added to Structural, go to [Logging into Structural for the first time](/app/logging-into-structural-for-the-first-time.md).

You do not use the **Users** list to manage user permissions.

* To [assign global permission sets](/app/admin/tonic-user-access/permissions/global-permission-set-access.md), use the **Global Permission Sets** tab.
* To [assign workspace permission sets](/app/workspace/workspace-access-management/workspace-sharing.md), go to **Workspaces** view.

## Viewing the Users list

To display the **Users** list:

1. In the Structural heading, click **Structural Settings**.
2. On **Structural Settings** view, click **Access Management**.
3. On the **Access Management** tab, click **Users**.

<figure><img src="/files/xEvGKXMFM3CdHpofHUdU" alt=""><figcaption><p>Users list on the Access Management tab of Structural Settings</p></figcaption></figure>

For each user, the list includes the following information:

* Name
* Email address
* When the user was most recently active in Structural

To use a column to sort the list, click the column heading. To reverse the sort order, click the column heading again.

## Removing a Structural user

You can remove a Structural user from the **Users** list. When you remove a user, you must select a new owner for that user's workspaces.

To remove a Structural user:

1. In the **Users** list, click the actions menu, then click **Remove User**.
2. If the user is the owner of any workspaces, then the **Transfer Workspace Ownership** panel displays.\
   \
   Select a user to be the new owner of the removed user's workspaces, then click **Next**.
3. On the **Remove User From Tonic** panel, click **Transfer & Remove**.

Note that when you remove a user, it does not remove the user from the value of the `TONIC_ADMINISTRATORS` environment setting. You must [update the environment setting manually](/app/admin/tonic-user-access/permissions/managing-admin-users.md). If a user or group is later added that has an email address or group name that is in the environment variable value, that user or group is granted the built-in Admin (Environment) permission set.

## Restoring a removed user <a href="#users-restore-deleted" id="users-restore-deleted"></a>

You can restore a removed Structural user. When you restore a user, Structural restores to the user:

* The global permission sets that they were assigned.
* The workspace access that they were granted.

To view the list of removed, users, on the **Access Management** tab of **Structural Settings**, click **Deleted Users**.

<figure><img src="/files/ZHFdsftMNu1lIRncBpTh" alt=""><figcaption><p>Deleted Users list</p></figcaption></figure>

To restore a removed user:

1. In the **Deleted Users** list, click the restore icon for the user.
2. On the confirmation panel, click **Restore User**.

## Resetting a user password

{% hint style="info" %}
**Required global permission:** Reset Tonic user passwords
{% endhint %}

From the **Users** list, if your instance does not use SSO to manage users, you can reset a user's password. You would most likely do this in response to a request from a user who forgot their password.

The reset password option sends an email to the user to allow them to set up a new password.

To reset a password, in the **Users** list, click the actions menu for the user, then click **Reset Password**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tonic.ai/app/admin/tonic-user-access/users-tonic-managing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
