# Users

Application **Users** are people who work for your organization and will be using Mifos X to track all the information about your organization's operations. For example, an accountant working at a branch needs a user account in this application to track all the accounting related tasks and information. Similarly, a branch manager needs a user account to manage his/her client's portfolios.

In this section, you will learn how to add, delete or modify your organization’s users. These are people with system access working at the offices within your organization. They are subject to different restrictions based on the roles assigned to them (by the system administrator).

Before setting up usernames, the organization should give thought to the standard that will be used throughout the organization. This may be first.lastname; it may be a numerical identifier such as 101lastname (indicating the main office) or 201lastname indicating a branch office.  Whatever the method adopted by your organization, it should be consistently used when creating users.

From the main screen, click on [**Admin**](https://docs.mifos.org/mifosx/user-manual/for-administrators-mifos-x-platform/administration) then select **Users** from the drop down list.

![](https://2235457518-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lb-oDYAENt-r5hW1bjo%2F-Lg8Ci3WlAqW7I7w2avU%2F-Lg8D3OogTLx9bZgj6LP%2FusersSelection.jpeg?alt=media\&token=0c1be8dd-7772-4e46-9815-61bcf489658f)

This will launch the users page that displays a list of Users with their details *(refer to the screenshot below)* such as:

* First Name
* Last Name
* Email
* Office

![](https://2235457518-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lb-oDYAENt-r5hW1bjo%2F-Lg8Ci3WlAqW7I7w2avU%2F-Lg8DIZlCX2ou92hMRj0%2FusersPage.png?alt=media\&token=18257a60-c6f2-4d6b-a051-f463441273b0)

**Tip:** Use the **Filter by Name** feature at the top of the screen to avoid scrolling through all the entries. Just begin typing the name you are looking for and Mifos X will automatically narrow down the search for you.

### **Create a User** <a href="#users-createauser" id="users-createauser"></a>

#### **Tip: Before you start to create Users, please ensure that you have created their respective Roles (for more information, see** [**Manage Roles and Permissions**](https://docs.mifos.org/mifosx/user-manual/for-administrators-mifos-x-platform/administration/system/manage-roles-and-permissions)**).**&#x20;

Start this process by clicking on the blue **Create User** button at the top-right corner of the **Users** screen.

![](https://2235457518-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lb-oDYAENt-r5hW1bjo%2F-Lg8Ci3WlAqW7I7w2avU%2F-Lg8EobgWmCnYoJAw7ZG%2Fcreateuser.png?alt=media\&token=a9e1841f-4d20-4561-a60e-427246bae25a)

You will then be prompted to fill in a series of fields and define the new user's office and role(s), such as:

* Username
* First Name
* Last Name
* Email
* Office
* Selected Roles

**NOTE: Fields marked with asterisks ('\*') are mandatory.**

* By default, the **Auto generate password** checkbox will be checked. It will send an auto generated password to the provided Email ID.<br>
* Alternatively, un-checking the box will allow you to provide a password manually. This will give you access to the **Password** and **Repeat Password** fields that allow you to create your own password.

![](https://2235457518-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lb-oDYAENt-r5hW1bjo%2F-Lg8Ci3WlAqW7I7w2avU%2F-Lg8Ft5qkx_PFRJ8SPAE%2Fpassword.png?alt=media\&token=51d4e2dc-0fb7-4840-b6a5-e57091caccae)

* Select the associated office of the new user from the drop-down menu:

![](https://2235457518-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lb-oDYAENt-r5hW1bjo%2F-Lg8Ci3WlAqW7I7w2avU%2F-Lg8G7MJI64a8irh2gyG%2FofficeSelect.png?alt=media\&token=6f792f1c-901e-40ee-a73a-ce4745fe8c8a)

* Select a role from the **Available Roles** menu to be added to the **Selected Roles**  section by clicking the ![](https://mifosforge.jira.com/wiki/download/attachments/67141740/forward.png?version=1\&modificationDate=1552919317808\&cacheVersion=1\&api=v2) button. To add more than one role at once, hold the Ctrl key while clicking on the appropriate roles. Selected roles will be highlighted in blue and then you can forward all of them at once to the Selected Roles section.

![](https://2235457518-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lb-oDYAENt-r5hW1bjo%2F-Lg8Ci3WlAqW7I7w2avU%2F-Lg8GLyWnLMZjxjA-On1%2FfowardSelected.png?alt=media\&token=7c26b637-98ca-4e59-b8a3-bb693b6ece75)

* To remove a role from the Selected Roles section, select the role and click the ![](https://mifosforge.jira.com/wiki/download/attachments/67141740/reverse.png?version=1\&modificationDate=1552919565391\&cacheVersion=1\&api=v2) button.

![](https://2235457518-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lb-oDYAENt-r5hW1bjo%2F-Lg8Ci3WlAqW7I7w2avU%2F-Lg8G_y4O1UHTIigPYXj%2FreverseSelected.png?alt=media\&token=91165869-a810-4a7f-8259-12244a86b706)

Once you have filled all the information fields, click the **Submit** button.

### **View User's Profile** <a href="#users-viewusersprofile" id="users-viewusersprofile"></a>

&#x20;To view a user, click on their **name** on the list and their profile will open. There will be additional information displayed such as:

* Login Name
* First Name
* Last Name
* Email
* Office
* Roles (*assigned to this user*)

![](https://2235457518-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lb-oDYAENt-r5hW1bjo%2F-Lg8Ci3WlAqW7I7w2avU%2F-Lg8GrvCdAuZe0iwGVo8%2FusersProfile.png?alt=media\&token=30e7ef7a-81e0-48b6-a12d-a7bff67116b9)

Once you open a user's profile, you can perform the following actions:

* Edit user
* Delete user
* Change a password

### **Edit User** <a href="#users-edituser" id="users-edituser"></a>

You may edit the profile of current users within your organization. Follow these steps to do the so:

1. Navigate to the chart of current **Users** - If you are not sure how, please see the **View Application Users** section of this manual.
2. Select the user you would like to edit by clicking on their **name** in the chart (this will launch their profile).
3. Click the blue **Edit** button ![](https://mifosforge.jira.com/wiki/download/attachments/67141740/useredit2.png?version=1\&modificationDate=1402359825419\&cacheVersion=1\&api=v2) at the top-right of the page. This will open the user's profile, allowing you to make several changes.&#x20;

![](https://2235457518-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lb-oDYAENt-r5hW1bjo%2F-Lg8Ci3WlAqW7I7w2avU%2F-Lg8H6RZTXrsJzrLDUwm%2FeditUser.png?alt=media\&token=0675fc1a-e492-4196-af1d-9f3fae293895)

Once you have opened the user's profile for editing, you may modify the following fields:

* Username
* First and last name
* Email
* Selecting staff that report to this user by using the drop-down menu marked **Staff**:

![](https://mifosforge.jira.com/wiki/download/attachments/67141740/staff.png?version=1\&modificationDate=1552920958857\&cacheVersion=1\&api=v2)

* Transfer user account from one office to another office by selecting the office drop-down menu.

After making changes, click **Submit**.

### **Change User Password** <a href="#users-changeuserpassword" id="users-changeuserpassword"></a>

1. Navigate to the list of current **Users** - If you are not sure how, please see the **View** **Users**section of this manual.
2. Select the user whose password you would like to change by clicking on their **name** in the list. This will launch their profile.
3. Click the blue **Change Password** button ![](https://mifosforge.jira.com/wiki/download/attachments/67141740/userchangepw.png?version=1\&modificationDate=1402360045531\&cacheVersion=1\&api=v2) at the top-right of the page.
4. This will launch a pop-up window:

![](https://2235457518-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lb-oDYAENt-r5hW1bjo%2F-Lg8Ci3WlAqW7I7w2avU%2F-Lg8HRVjAPtkc1i5wcZw%2F35.PNG?alt=media\&token=f1806b4e-b23a-406a-a945-80aee2cf4148)

1. Fill in the **Password** and **Repeat password** fields.
2. Click **Submit**.

### **Delete User** <a href="#users-deleteuser" id="users-deleteuser"></a>

1. Navigate to the chart of current **Users** - If you are not sure how, please see the **View Application Users** section of this manual.
2. Select the user you would like to delete by clicking on their name in the chart. This will launch their profile.
3. Click the blue **Delete** button ![](https://mifosforge.jira.com/wiki/download/attachments/67141740/userdelete.png?version=1\&modificationDate=1402359844452\&cacheVersion=1\&api=v2) at the top-right of the page.
4. Click **Confirm**.

### **Override password expiry policy** <a href="#users-overridepasswordexpirypolicy" id="users-overridepasswordexpirypolicy"></a>

This option determines whether the password expires or not for this user even if the global configuration for password expiry is enabled.&#x20;

This means that checking this check box will grant you access using the same password, regardless of whether global configuration for password expiry is enabled.&#x20;

![](https://mifosforge.jira.com/wiki/download/attachments/67141740/overridePasswordPolicy.png?version=1\&modificationDate=1552923204412\&cacheVersion=1\&api=v2)

Related articles

* Page:[Users](https://docs.mifos.org/mifosx/user-manual/for-administrators-mifos-x-platform/administration/users)
* Page:[Audit Trails](https://docs.mifos.org/mifosx/user-manual/for-administrators-mifos-x-platform/administration/system/audit-trails)
* Page:[Chart of Accounts - General Ledger Setup](https://docs.mifos.org/mifosx/user-manual/for-administrators-mifos-x-platform/accounting/chart-of-accounts-general-ledger-setup)
* Page:[Manage Roles and Permissions](https://docs.mifos.org/mifosx/user-manual/for-administrators-mifos-x-platform/administration/system/manage-roles-and-permissions)
* Page:[Configure Maker-Checker Tasks](https://docs.mifos.org/mifosx/user-manual/for-administrators-mifos-x-platform/administration/system/configure-maker-checker-tasks)
