# Managing Users

> Source: https://parallelworks.com/docs/organization-admin/managing-users

# Managing Users

This page explains how to list, create, import, edit, and delete users on ACTIVATE.

## Listing Users

From the **Organizations** list, select your organization. The **Users** page is the default view.

The users table displays the following columns:

- **User** — Avatar, display name, and email address. A green dot on the avatar indicates the user is currently online (active within the last 60 seconds).
- **Status** — Shows **Active** (green badge) for licensed users or **No license** (amber badge) for users without a license.
- **Last Login** — The date and time of the user's most recent login.
- **Actions** — Available actions such as **Impersonate user** (platform administrators only).

### Searching and Filtering

Use the **search field** above the table to filter users by username or email. Results update automatically as you type.

Filter pills below the search field let you narrow the list:

- **All** — Show all users.
- **Active** — Show only users with an active license.
- **No license** — Show only users without a license.

### Sorting

Click the **Username** or **Last Login** column headers to sort the table by that column. Click again to reverse the sort order.

### Pagination

The table displays 50 users per page. Use the **Previous** and **Next** buttons at the bottom of the table to navigate between pages.

The table auto-refreshes every 30 seconds to keep the data current.

## Creating New Users

To create a new user individually:

1. On the **Users** page, click the **Add user** button in the top-right corner.

2. Fill in the form fields, which are arranged in a 2x2 grid:

   - **Name** — The user's display name.
   - **Username** — Must contain only alphanumeric characters, periods, and hyphens.
   - **Email** — The user's email address.
   - **Password** — Must meet complexity requirements (see below).

3. Click **Create user** to submit.

### Password Requirements

Passwords must meet all of the following complexity requirements:

- Minimum length
- At least one uppercase letter
- At least one lowercase letter
- At least one number
- At least one special character

:::info
We do not send any emails regarding the creation of new users. You will need to share the login credentials with the user directly.
:::

## Importing Users

The import feature lets you create multiple users at once using a CSV file. It can also be used for mass-updating existing users.

1. On the **Users** page, click the **Import** link next to the **Add user** button.

2. Follow the 3-step process:

### Step 1: Download Template

Click **Download template** to download a CSV file. Open the file in any spreadsheet editor (Excel, Numbers, Google Sheets, etc.).

### Step 2: Fill In the CSV

The CSV template includes the following fields:

| Field | Description |
|-------|-------------|
| `username` | Required. The user's login name. |
| `password` | The user's password. |
| `name` | The user's display name. |
| `email` | The user's email address. |
| `uid` | Optional. A custom user identifier. |
| `groups` | Optional. Group names separated by semicolons (e.g., `engineering;design`). |
| `active` | Whether the user account is active. |

### Step 3: Upload and Import

1. Click **Upload template** and select your completed CSV file.
2. A preview table displays the uploaded data. Review it for accuracy.
3. Click **Import** to create the users.

After the import completes, an **Import Log** appears showing per-user results, including any errors that occurred.

:::info Troubleshooting
On macOS, spreadsheet applications may attempt to save a CSV file in a different format (e.g., `.numbers` or `.xlsx`). Ensure you save the file as a `.csv` before uploading, as the import feature only accepts CSV files.
:::

## Editing Users

Click a username in the users table to open the user detail page.

The user detail page uses a two-column layout:

- **Left column — User Details panel**
  - **Username** — Read-only, cannot be changed after creation.
  - **Name** — Editable display name.
  - **Email** — Editable email address.
  - **Status** — Current account status.
  - **Created** — Date the account was created.
  - **Organization** — The organization the user belongs to.

- **Right column — User Activity** (platform administrators only)
  - Displays a graph of the user's activity over the past year.

Click **Update User** to save any changes to the user details.

### Feature Previews

Organization administrators can toggle feature flags for individual users in the **Feature Previews** section of the user detail page. This is useful for enabling upcoming features for testing.

### Platform Admin Settings

Platform administrators have access to additional settings:

- **No seat** — When enabled, the user does not consume one of the organization's allotted seats. Useful for service accounts or test accounts.
- **Admin** — Grants the user platform administrator privileges.

## User Detail Sub-Pages

The user detail page includes a navigation bar at the top with links to the following sub-pages:

### Groups

View and manage the user's group memberships.

- Use the dropdown to add the user to a group.
- Click the trash icon next to a group to remove the user from it.

### Workspace

Configure the user's workspace settings:

| Setting | Description |
|---------|-------------|
| **Type** | Workspace type (Docker or Kubernetes). |
| **User Host** | The host where the workspace runs. |
| **Image** | The container image for the workspace. |
| **CPU Min / Max** | Minimum and maximum CPU allocation. |
| **Memory Min / Max** | Minimum and maximum memory allocation. |
| **Ephemeral Storage Max** | Maximum ephemeral storage capacity. |
| **Debug Mode** | Enable debug mode for troubleshooting. |

### External Auth

View and edit external authentication mappings for each configured authentication method. Available fields depend on your organization's auth configuration and may include:

- **CAC ID**
- **LDAP UID**
- **OIDC Sub**

### Delete

A delete confirmation page that displays the resources associated with the user that will be cleaned up upon deletion. See [Deleting Users](#deleting-users) for details.

## User Actions

The user detail page includes an action bar with the following options. Available actions depend on your role.

### Impersonate User

*Platform administrators only.*

Click **Impersonate User** to log in as the selected user. This is useful for troubleshooting issues from the user's perspective.

### Restart Workspace

Click **Restart Workspace** in the action bar. A confirmation dialog will appear asking: *Are you sure you want to restart [user's] workspace?*

Click **Restart** to confirm. This is useful if the user is experiencing platform errors.

:::info Troubleshooting
Please contact us if restarting the workspace does not resolve the user's errors.
:::

### Disable / Enable User

Click **Disable User** to deactivate the account. Disabled users:

- Cannot log in to ACTIVATE.
- Do not consume one of the organization's allotted seats.

To re-enable the account, click **Enable User** from the same action bar.

:::caution
A warning is displayed if the user has active resources when you attempt to disable their account.
:::

### Change Password

Click **Change Password** to open a modal with two fields:

- **New Password** — Enter the new password (must meet password complexity requirements).
- **Confirm Password** — Re-enter the new password.

### Remove MFA

*Platform administrators and organization administrators only.*

Click **Remove MFA** to remove multi-factor authentication from the user's account. The user will need to set up MFA again on their next login if MFA is required by the organization's policies.

### Revoke Login Sessions

Click **Revoke Login Sessions** to force the user out of all active sessions. The user will need to log in again.

### Delete User

Click **Delete User** to navigate to the delete confirmation page. See [Deleting Users](#deleting-users) for details.

## Deleting Users

To delete a user:

1. Navigate to the user detail page by clicking their username in the users table.
2. Click **Delete User** in the action bar, or navigate to the **Delete** sub-page.
3. The delete confirmation page displays a list of resources associated with the user, including each resource's name, type, and status.

4. Click the **Delete** button.
5. A confirmation modal appears. Confirm the deletion.

:::caution
If the user has active resources, an amber warning explains that those resources will be deprovisioned as part of the deletion process.
:::

## Monitoring User Status

In the users table, users who have been online within the past minute display a green status dot on their avatar. This provides a quick way to see which users are currently active on the platform.
