# 4.2 Users

### Video setup guide

{% embed url="<https://www.loom.com/share/a9f457627c55490bb83daba983f79039>" %}
Managing users
{% endembed %}

### Written setup guide

To access the User management page,

* On the left hand menu bar, click on ***Settings***

![](/files/-LEUwVIq3S3kiS4OtUQR)

* Then, click on ***Users***.

![Settings -> Users](/files/-LEUwb5ydfk3kbMNyEmu)

* You’ll be redirected to a page with a list of all existing users on your deployment
* If you are an ushahidi.io user, you should see the the user you created on set up listed on this page. If you are an ushahidi open source user, every installation comes with a default username: ***admin*** and password: ***admin***
* From here, you can search for users either by name or by custom role

![](/files/-LEUwb62QiZOgCBRCNIs)

![](/files/-LEUwb64eMG9aDaFZL2d)

*

## 4.2.1 Adding new users <a href="#id-4-2-1-adding-new-users" id="id-4-2-1-adding-new-users"></a>

To add a new user,

* Click on the ***yellow icon*** as shown below

![](/files/-LEUwb661pOEPsoh2xL4)

* Fill out the details below
* * ***Display Name***: This is the name that will be displayed
  * ***Email address:*** This is the email address that will be tied to this new user’s account, and will be used to log in.
  * ***Password:*** Set a strong and secure password for your new user. Each password must have at least 7 characters
  * ***Role:*** Choose the level of administration access you would like this user to have
* Click on ***Save*** to create one.

![](/files/-LEUwb6EUWftZa7HNztK)

## 4.2.2 Editing users <a href="#id-4-2-2-editing-users" id="id-4-2-2-editing-users"></a>

To edit a user,

* Click on the user you intend to edit from the user list page

![](/files/-LEUwb6HVGlbi7cI_kqi)

* You should be able to edit the user’s display name, email address, password and user role from this page.

![](/files/-LEUwb6JdvMe5FhoEWXw)

* Click on ***save*** when done.

## 4.2.3 Changing User roles <a href="#id-4-2-3-changing-user-roles" id="id-4-2-3-changing-user-roles"></a>

You can change multiple users’ roles at once from the user management page.

* Tick the checkbox on the left, adjacent to the user(s) whose role you would like to change from the user list page
* This action will activate the previously inactive ***Change Role*** dropdown button on the top menu bar.

&#x20;                          ![](/files/-LEUwb6LuSfL1OpEtILN)

* Click on this dropdown and select the role you would like to assign your users to.

&#x20;                          ![](https://lh6.googleusercontent.com/3ucmmMpgmX4aHGdiMCtcjs1S8vePeBO4p-7ZzIbwb9QKHSddr7l44zXcnHWB4C_vpevGifmZIUq2PQykIuB3YNMvFpixwXI7qzcYGrMYGa4YvzdJlIWtLH2bOk-MimcQ0yYp4Dbt)

* A pop up box will appear, prompting you to confirm whether you would like to change the roles of your user(s)

  * Click on ***OK*** to change your user(s) role
  * If you’d like to cancel the role change process, click on ***Cancel.***

  &#x20;                    ![](https://lh3.googleusercontent.com/G3RIt1dIt0RfdCS3OsXe3-S1vBqCIVjmcHvsI-l2uSsY_ZQn0_lzusHX5uTS6iFOQqw5BSRgMcx_8DwkvJX9uZVi7nZbUoP9VVDDlNbSwDOVmA-cPlhXWaQ3UemcEJan88ggPhcs)

## 4.2.4 Deleting users <a href="#id-4-2-4-deleting-users" id="id-4-2-4-deleting-users"></a>

Similarly, you can delete multiple users at once from the user management page, or from the individual user edit page.

To delete a user

* From the individual user edit page

  * Click on the user you intend to edit from the user list page.

  &#x20;            ![](/files/-LEUwb6T50iuJ4nbuVqc)

  * Click on ***Delete User.***

&#x20;                     ![](/files/-LEUwb6VeLFT6WPy5eIr)

* A pop up box will appear on the top of the page, prompting you to confirm whether you would like to delete your user

  * Click on ***Delete*** to delete your user
  * If you’d like to cancel the user deletion process, click on ***Cancel.***

  &#x20;             ![](/files/-LEUwb6X3fzEYkO8xDyf)
* From the User management page
  * Tick the checkbox on the left, adjacent to the user(s) you would like to delete from the user list page
*

```
* This action will activate the previously inactive _**Delete**_ button on the top menu bar. Click on it to initiate the deletion process.
```

```
&#x20;             ![](/files/-LEUwb6cE4hZRhkbIQX6)

*   A pop up box will appear, prompting you to confirm whether you would like to delete your user(s)

    * Click on _**DELETE**_ to delete your user(s)
    * If you’d like to cancel the user deletion process, click on _**Cancel.**_



    &#x20;     ![](/files/-LEUwb6l_HEgUFqaM2_8)
```


---

# 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.ushahidi.com/platform-user-manual/legacy/4.-managing-people-on-your-deployment/4.2-users.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.
