> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.fynapse.app/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.fynapse.app/_mcp/server.

# Users

> Learn how to manage Fynapse users effectively using the Users screen.

## Overview

The **Users** screen allows you to add users so that they can access Fynapse. The screen also allows you to edit, clone, and deactivate selected users.

## Users Screen

The **Users** screen comprises the following elements:

* The **Add** button - click it to create a new user
* The **Export as CSV** button - click it to export a list of users with their details to a file
* The **Refresh** button - click it to update information about users
* The grid - use it to see a list of all added users. The grid has the following columns:
  * **Username** - a unique name typed in while creating the user or received from the external identity provider
  * **Display name** - a name that is used to refer to a particular user within Fynapse
  * **E-mail** - a user’s e-mail address
  * **Status** - informs about the status of a user:
    * **Active** - the user can log into Fynapse
    * **Inactive** - the user cannot log into Fynapse
  * **Groups** - names of groups to which the user belongs
  * **Updated on** - a date when the last changes to the user were saved
  * **Details** - contains the chevron, which you can click to view details for a selected user. To go back to the **Users** screen, click the breadcrumb.

Additionally, you can:

* Sort columns ascending or descending, and set their visibility by clicking the three dot icon next to the names of columns
* Filter content within some columns to find particular information

In addition, at the bottom of the screen, you can:

* See a number of pages that display users and buttons to navigate between pages
* See information which page you are currently viewing and how many pages are available in total
* Decide how many users you want to display on one page
* See how many users are presented on the page

## Users Details Screen

This screen is displayed if you click the chevron in the **Details** column. The screen comprises the following elements:

* The action buttons:
  * The **Edit** button - click it to edit a selected user. If the user was created within Fynapse, the user’s e-mail address, display name, as well as an assignment to groups and roles can be modified. However, if the user was created by the external identity provider, then only the assignment to groups and roles can be modified.
  * The **Clone** button - click it to clone the selected user
  * The **Deactivate/Activate** button - click it to deactivate or activate the selected user
* User's details in dedicated panels:
  * **Details** - contains basic information about the user
  * **History** - contains information about who and when created and updated the user
  * **External user federation** - contains information about the external identity provider associated with the user (if such a connection exists)
  * **Groups** - contains information to which groups the user is assigned. You can click the name of the group to see its details.

## Tutorials

#### How to Add a User?

1. Go to **Security > Users**.
2. Click the **Add** button.
3. Provide basic information about a user:
   1. Into the **Username** field, type a unique username.
      > **Info**
      >
      > You will not be able to change the username after saving.
   2. Into the **Display name** field, type a name that will be used to refer to this user.
   3. Into the **E-mail** field, type an e-mail address associated with this user.
   4. Select the **Active** checkbox if the user must be active after saving.
4. In the **Groups** panel, select checkboxes next to the groups the user should belong to.
5. Click the **Save** button to save the user or the **Cancel** button to discard your changes. The new user will appear in the **Users** grid and will get an email informing them to reset their password to set a new one that they will use to log in to their Fynapse account.

#### How to Activate a User?

1. Go to **Security > Users**.
2. On the list, find a user you want to activate and in the **Details** column, click the chevron.
3. Click the **Activate** button.

#### How to Deactivate a User?

1. Go to **Security > Users**.
2. In the grid, find a user you want to deactivate and in the **Details** column, click the chevron.
   > **Info**
   >
   > Once you click the **Deactivate** button, the selected user will not be able to use Fynapse.
3. Click the **Deactivate** button.
4. Confirm the action by clicking the **Deactivate** button. The user will be deactivated and unable to log in to Fynapse. The status for this user will change to **Inactive**.

#### How to Edit a User?

1. Go to **Security > Users**.
2. In the grid, find a user you want to edit and in the **Details** column, click the chevron.
3. Click the **Edit** button.
4. Introduce necessary changes. You can change an email address, display name, as well as an assignment to groups and roles for users created internally.
5. Click the **Save** button to save the user or the **Cancel** button to discard your changes.
6. Notify the user that they need to log in to Fynapse again.

#### How to Clone a User?

1. Go to **Security > Users**.
2. In the grid, find a user you want to clone and in the **Details** column, click the chevron.
3. Click the **Clone** button.
4. Introduce necessary changes.
5. Click the **Save** button to save the user or the **Cancel** button to discard your changes.

#### How to Export Users from Fynapse to a File?

1. Go to **Security > Users**.
2. Click the **Export as CSV** button.
3. You may be prompted to provide a location where the file will be saved or the location will be automatically selected (it depends on your web browser configuration). The file containing users with their details will be downloaded.

## Learn More

* [Roles](/documentation/instance-management/security/security-management/roles)
* [Groups](/documentation/instance-management/security/security-management/groups)
* [Data Permissions](/documentation/instance-management/security/security-management/data-permissions/data-permissions-overview)
* [Default System Roles Overview](/documentation/instance-management/security/security-management/data-permissions/data-permissions-overview)
* [Security Best Practices](/documentation/instance-management/security/security-management/security-best-practices)