# Manage users

## User types and roles

User
: A user has full access to the functionality of Datalore. Their admin rights depend on the assigned role:
:
:
:
: * Regular: Can create notebooks, workspaces, and reports but has no admin rights.
:
: * Admin: Has access to the `Admin panel`.
:
: * Super Admin: Has access to the `Admin panel` and can change other users’ roles. The first user registered in a Datalore installation is automatically granted the Super Admin role.

Viewer
: A special type of users who can only view notebooks and reports shared with them by other Datalore users. Viewers cannot create their own notebooks, workspaces or publish reports. They also cannot be assigned roles.
:
:
:
: > **Tip:**
: > You can [upgrade existing viewers to users](#viewer-to-user) and [downgrade users to viewers](#user-to-viewer).

## Plans

Plans are used to limit resources that are available for users. You [define plans](configure-plans.html) in Datalore configuration files and then assign them to users from the `Admin panel`.

Default personal plan
: Assigned to all users by default according to your Datalore configuration.
:
:
:
: Super Admins can change it to a non-default personal plan or group plan in the Admin panel.

Non-default personal plan
: Can be assigned to individual users in the `Admin panel`.
:
:
:
: When assigned, the non-default personal plan takes priority over any group plans that are currently associated with or will be associated with this user until a different personal plan is assigned.

Group plans
: Super Admins can assign group plans to all group members when creating or editing a group in the `Groups` section of the `Admin panel`. Group plans are a convenient way to assign the same plan to several people who do not have personal plans assigned to them.
:
:
:
: When a user is a member of several groups, the plan listed last in the plan configuration has priority over the other group plans associated with this user.
:
:
:
: To learn more about managing group plans, see [Manage user groups](manage-user-groups.html).

## Procedures

Procedure: Access the Manage users tab

> **Note:**
> Requires the Admin or Super Admin role.

1. Click your avatar at the top right and select Admin panel.

![Opening Admin panel](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/admin-panel.png)

2. The Manage users tab of the Admin panel will open.

![User list](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/user_list.png)

> **Tip:**
> To collapse or expand the sidebar, click the icon at the top left, or drag its right edge to resize it.

Procedure: View or search the user list

> **Note:**
> Requires the Admin or Super Admin role.

* To sort the list of users by category, click the corresponding column header.

* To search users by their ID or email, or to filter the list, use the search bar at the top.

> **Note:**
> The search output is limited to 100 records.

![User list](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/user_list.png)

Procedure: Create a user

A user has full access to the functionality of Datalore and can have different admin permissions depending on the role.

The procedure for creating a user depends on whether you use Datalore with Hub. If you do not know what Hub is, your installation most likely does not use it.

Datalore:

You can create users directly in Datalore’s `Admin panel` only if you log in directly without Hub.

> **Note:**
> Requires the Admin or Super Admin role.

To create a user:

1. In the Admin panel, select Manage users on the sidebar.

2.

Click the plus icon next to the Manage users.

![Manage users section on the sidebar in Datalore’s Admin panel](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/plus_user.png)

3.  In the New user dialog that opened, enter the new user’s full name, email, and password.

4.  To assign the Viewer type to the new user, expand the list under User type and select Viewer.

5.

To assign a role other than the default Regular, expand the list under User role and select the required role.

Only Super Admins can assign the Super Admin role to a new user.

> **Warning:**
> Roles cannot be assigned to viewers.

6.  (Optional) To disable onboarding tips for the new user, select the Skip onboarding checkbox.

7. Click Create user.

![Screenshot of the New user dialog](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/create_user.png)

Datalore with Hub:

If your installation uses Hub, you can create Datalore users only in Hub.

For instructions, see [Create user accounts](https://www.jetbrains.com.cn/en-us/help/hub/Creating-User-Accounts.html) in the official Hub documentation.

Procedure: Create a viewer

A viewer is a special type of users who can only view notebooks and reports shared with them by other Datalore users.

The procedure for creating a viewer depends on whether you use Datalore with Hub. If you do not know what Hub is, your installation most likely does not use it.

Datalore:

> **Note:**
> Requires the Admin or Super Admin role.

To create a viewer, follow the steps in [Create a user](#create-user) and select Viewer in User type.

Datalore with Hub:

If you are registered in Datalore via Hub, you create a viewer role in Hub and assign it to a user.

1. To create the Datalore Viewer role:

1. In Hub, go to `Roles | New role`.

2.

Enter the role name, for example, Datalore viewer, and click Create.

You will need this role name when granting the role to a user.

3.

In Settings, specify the role key (`datalore-viewer`).

> **Tip:**
> Alternatively, you can specify the role key in the Datalore environment:
>
>
>
>
> ```YAML
> HUB_VIEWER_ROLE_KEY: "datalore-viewer"
> ```

2. To assign the Datalore Viewer role to a user:

1. In Hub, go to the Users page and select the user.

2. Switch to the Roles tab and click Grant role.

3.  In the Grant role dialog that opened, enter Datalore Viewer in the Role field.

4. In Scope, select Global, unless configured otherwise.

5. Click Grant.

> **Note:**
> You can also [downgrade an existing user to a viewer](#user-to-viewer).

Procedure: View user profile

> **Note:**
> Requires the Admin or Super Admin role.

The user profile allows you to view user information, manage their plans and roles, and access their workspaces.

To open the user’s profile:

1. In the Admin panel, select Manage users.

2. Select the user whose information you want to access.

![User detail view](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/user_profile.png)

Optional steps:

* To copy the link to the user’s profile, click the link icon in the title.

* (For installations with Hub) To view the user in Hub, click See profile under Hub.

* To view specific information, switch to the corresponding tab: * General: User type, user role, last access date, and other information * Resources: User’s plan, license, and machine and storage usage information * Computations: User’s machines that are currently running * Workspaces: User’s Home and own workspaces

* To verify the user’s email, click Verify email. You can also resend the verification email.

Procedure: Upgrade a viewer to a user

> **Note:**
> Requires the Super Admin role.

1. In the Admin panel, select Manage users.

2. Select the viewer account you want to upgrade to a user.

3. On the `General` tab, open the dropdown in `Type` and select `User`.

Procedure: Downgrade a user to a viewer

> **Note:**
> Requires the Super Admin role.

> **Warning:**
> When you downgrade a user to a viewer, all their workspaces, notebooks, reports, and attached files will be deleted.
>
>
>
> This action is irreversible, and the deleted data cannot be recovered. Before you continue, make sure you have a copy of all the data you need.

1. In the Admin panel, select Manage users.

2. Select the user account you want to downgrade to a viewer.

3. On the `General` tab, open the dropdown in `Type` and select `Viewer`.

4. Follow the prompts.

Procedure: Change user's role

> **Note:**
> Requires the Super Admin role.

Roles determine what admin privileges the user has access to.

To change the role:

1. In the Admin panel, select Manage users.

2. Select the user whose role you want to change.

3. On the General tab, select the new role under Role:

![Changing role](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/change_role.png)

Procedure: Change user's plan

> **Note:**
> Requires the Super Admin role.

To change the user’s plan:

1. In the Admin panel, select Manage users.

2. Select the user whose plan you want to change.

3. Switch to the Resources tab.

4. Select the required plan under Plan.

![Assigning plans to a user](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/assign_plans.png)

The plan you select will override any group plans assigned to the user.

> **Tip:**
> To learn more about plan configuration, refer to [Configure plans](configure-plans.html)).

Procedure: Manage user's computations

> **Note:**
> Requires the Super Admin role.

1. In the Admin panel, select Manage users.

2. Select the user whose computations you want to manage.

3. Switch to the Computations tab.

4. To sort the list of computations, click the respective column header.

5. To stop a computation, click the ellipsis icon next to it and select the Stop in the popup menu.

![Stopping a computation](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/manage_comp.png)

6. To copy the notebook identifier of a specific computation, click the corresponding copy icon in the Notebook column.

Procedure: Manage user’s workspaces

> **Note:**
> Requires the Super Admin role.

1. In the Admin panel, select Manage users.

2. Select the user whose workspaces you want to manage.

3. Switch to the Workspaces tab.

4. To open a workspace, click the corresponding ellipsis icon and select Open in the popup menu.

![Opening a user’s workspace](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/open_ws.png) You will access the workspace from a new browser tab. As an admin, you can manage the workspace with edit rights.

5. To create a workspace that will be the user's own, do the following:

1. Expand the Actions menu at the bottom of the user's profile and select Create workspace for user.

![Manage workspaces](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/manage_wks.png)

2. In the New workspace dialog, provide a title for the new workspace and click Create workspace.

Procedure: Ban a user

> **Note:**
> Requires the Super Admin role.

When you ban a Datalore user, their account remains in the system, but they cannot perform any actions.

> **Warning:**
> You cannot use the seats of banned users for new accounts. Seats are released only when [users are deleted](#delete-user).

To ban a user:

1. In the Admin panel, select Manage users.

2. Select the user you want to ban.

3. At the bottom of the modal, click Actions and select Ban user.

4. (Optional) In the Ban user dialog, specify a reason for banning.

5. Click OK.

6. To unban the user, click Actions and select Unban user.

Procedure: Delete a user

> **Note:**
> Requires the Admin or Super Admin role.

When you delete a user, it releases that associated seat and deletes all user data.

> **Warning:**
> Deleting a user permanently deletes the data associated with this user, including all notebooks and their published versions. This action is irreversible, and the deleted data cannot be recovered.

1. In the Admin panel, select Manage users.

2. Select the user you want to delete.

3. At the bottom of the modal, click Actions and select Delete user.

4. In the Delete user dialog, click OK.

Procedure: Disable user registration

> **Note:**
> Requires the Super Admin role.

To configure whether users can register in your Datalore On-Premises instance:

1. Open the Manage users section.

2. Click Disable registrations at the top

3. To re-enable user registrations, click Enable registrations.