> For the complete documentation index, see [llms.txt](https://docs.ngsurvey.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ngsurvey.com/multi-user-management/users.md).

# Users

You can manage all the ngSurvey users using the user management interface&#x20;

![](/files/-MBDMZ9btvP3Gz43zgvz)

The user management interface let you&#x20;

1. Create new users
2. Edit existing users
3. Set [roles](/multi-user-management/roles.md) for the users

## ➕ Creating a user

To create a new user you may click **Add new user**

{% hint style="info" %}
User cannot self register, you have to create their account manually.
{% endhint %}

## 🔅 User properties

* **`Username`** Username ,must be unique across all users
* **`First name`** First name of the user.
* **`Last name`** Last name of the user.
* **`Email`** Email of the user.
* **`Mobile phone number`** Mobile phone number of the user.
* **`Password`** Password to login.
* **`Language`** Language used for the administration interface.
* **`Require password update on login`** User is required to change its password the first time he logs in.
* **`Login attemps`** number of unsuccessful login attemps for that account.
* **`Desactivated`** Activate or disactivated the account. The user will not be able to login anymore if its disactivated.&#x20;

{% hint style="info" %}
🧙 The **First name, last  name** and **email** are used as a sender for [email campaigns](/form-management/campaigns/campaign/email-distribution/email.md) and email related tasks.

The **mobile phone number** is used as a sender for the [SMS phone campaigns](/form-management/campaigns/campaign/phone-sms-distribution.md).&#x20;
{% endhint %}

## ❌ Deleting a user

Deleting a user cannot be reversed. Surveys of the user are not deleted with the account, these surveys are re-assigned to the first available administrator account.

## 🔑 User Roles

User roles define the rights that the user will have within the administration section.

![](/files/-MBEO6DkIgOcyO6STzkz)

{% hint style="warning" %}
The **administrator** right will grant the user all the rights and also give the user access to all the surveys.&#x20;
{% endhint %}

{% hint style="info" %}
**Assign all surveys** will grant access to all surveys that were created within ngSurvey without the need of giving full administrator rights.
{% endhint %}

## 🔒 Account lock out

After 10 failed attempts to login ngSurvey will automatically lock out the account for 5 minutes. You can configure the number of failed attempts and lock up delay using following environment variables.

* ***NGSurvey:AccountLockoutThreshold*** is the number of allowed failed attempts&#x20;
* ***NGSurvey:AccountLockoutDuration*** defines in minutes the delay before the login process can be started again.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.ngsurvey.com/multi-user-management/users.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
