# 4.2 Users

***

### Video setup guide

{% hint style="info" %}
Video coming soon
{% endhint %}

***

### Written setup guide

To access the User management page, on the sidebar, click on ***Settings***

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FZOWNT6bdpIGM0iMR2GqH%2F6.8.1.png?alt=media&#x26;token=c0c46d23-d26d-4656-9e78-9346e642688f" alt="Settings Link highlighted in the Ushahidi sidebar"><figcaption><p>Settings Link highlighted in the Ushahidi sidebar</p></figcaption></figure>

***

Then, click on ***Users***

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2Fctr2hx7BqIOaFsIeFZcB%2F4.2.1.png?alt=media&#x26;token=6bd54e44-5471-40c0-a910-7aa27a35fc67" alt="Settings -> Users button highlighted"><figcaption><p>Settings -> Users button highlighted</p></figcaption></figure>

***

***Then:***

* 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: ***admin123***
* From here, you can search for users either by name or by custom role

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FYWncYlJIW9v5ZDD1EfSz%2F4.2.2.png?alt=media&#x26;token=5758ef08-ecf0-40d2-b467-00b91bfdf192" alt="Search Users By name using the search bar highlighted."><figcaption><p>Search Users By name using the search bar highlighted.</p></figcaption></figure>

***

## 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

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FdKDKe02Tn3AAF0dqU5xU%2F4.2.4.png?alt=media&#x26;token=d124a004-6b44-4c73-ac38-1a8678b58b20" alt="Add User button highlighted to add new users."><figcaption><p>Add User button highlighted to add new users.</p></figcaption></figure>

***

***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.

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2F7LCGZIAwpPitftWQ9Rjd%2F4.2.5.png?alt=media&#x26;token=45a8af95-302d-47a1-8beb-f4a089882f6e" alt="Add User Form to input user&#x27;s details such as name, email and password."><figcaption><p>Add User Form to input user's details such as name, email and password.</p></figcaption></figure>

***

## 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

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FiyUtnM8rWG2d0OtwTzcy%2F4.2.6.png?alt=media&#x26;token=92678ff7-88a9-4994-a6f7-a8c8d8570089" alt="Click on the user intended to edit &#x22;Maxwell&#x22;"><figcaption><p>Click on the user intended to edit "Maxwell"</p></figcaption></figure>

***

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

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FAvwl7T7OluokZZTJpoCh%2F4.2.7.png?alt=media&#x26;token=47009dc8-9d35-4a47-a3b7-9ab2d53444ec" alt="Edit User form displaying password field to type new password."><figcaption><p>Edit User form displaying password field to type new password.</p></figcaption></figure>

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FaMc0kFs2tgVjgbQX0EXO%2F4.2.3.png?alt=media&#x26;token=664dcc4f-9d15-4924-bdaa-1088f27ff957" alt="Edit User form displaying role select field to select a new role for user &#x22;Maxwell&#x22;"><figcaption><p>Edit User form displaying role select field to select a new role for user "Maxwell"</p></figcaption></figure>

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

***

## 4.2.3 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 single user***, from the individual user edit page. Click on the user you intend to edit from the user list page.

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FBydaUKGmv8t54r0ZbwzJ%2F4.2.8.png?alt=media&#x26;token=fd6c4b8f-7529-4ef5-bdad-b16d0a39ae2b" alt="Click on a user &#x22;Sample User&#x22; to edit from the user list page."><figcaption><p>Click on a user "Sample User" to edit from the user list page.</p></figcaption></figure>

Click on ***Delete User***

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FMV7dGLnhjEfHyFPeRDTW%2F4.2.9.png?alt=media&#x26;token=8a9fecad-975f-42cb-9959-245e420411a7" alt="Delete User button highlighted to delete the selected user &#x22;Sample User&#x22;"><figcaption><p>Delete User button highlighted to delete the selected user "Sample User"</p></figcaption></figure>

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 ***Yes, delete*** to delete your user
* If you’d like to cancel the user deletion process, click on ***No, go back***

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2F3pwxpLwPf2FR7uY3vd96%2F4.2.10.png?alt=media&#x26;token=2acc76ba-12e7-4b65-8198-442921340778" alt="Delete &#x22;Sample User&#x22; confiramtion modal"><figcaption><p>Delete "Sample User" confiramtion modal</p></figcaption></figure>

***

To ***delete a multiple user***, from the User management page:

* Click on the ***bulk actions*** button
* Check/select the users to delete
* Click on the ***delete button or icon***

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FU0sn1DnbxxTnJl8Irwty%2F4.2.11.png?alt=media&#x26;token=3e8fb3b5-6d84-49ca-bcbb-ad71ebbba597" alt="Bulk actions highlighted to allow selection of multiple user and click on the highlighted delete icon to delete the selected users."><figcaption><p>Bulk actions highlighted to allow selection of multiple user and click on the highlighted delete icon to delete the selected users.</p></figcaption></figure>

A pop up box will appear, prompting you to confirm whether you would like to delete your users

* Click on ***Yes, delete*** to delete your user
* If you’d like to cancel the user deletion process, click on ***No, go back***

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FAhZmkoYxXO3aa5vtSR7J%2FScreenshot%202023-10-28%20172915.png?alt=media&#x26;token=f2c4beaf-e0a7-4748-8b4b-9a80c166bb7a" alt="Delete Users Confirmation Modal."><figcaption><p>Delete Users Confirmation Modal.</p></figcaption></figure>
