# Loan Products

Loan products define the rules, default settings, and constraints for a financial institution's lending offerings. A loan product provides a template for multiple loan accounts for the financial institution's clients.

The information required to set up a loan product includes:

* Identifying or descriptive information&#x20;
* Currency information&#x20;
* Terms
* Settings
* Tranche
* Charges
* Accounting

Beginning at the main screen, select [**Admin**](/mifosx/user-manual/for-administrators-mifos-x-platform/administration.md), then **Products** from the drop-down menu. This will launch the **Products** menu.

Select **Loan Products.**&#x20;

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/Screenshot%20from%202019-06-11%2015-08-43.png?version=1\&modificationDate=1560262578283\&cacheVersion=1\&api=v2\&width=850)

The Loan Products page will be displayed as shown below;

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/Screenshot%20from%202019-06-07%2006-01-41.png?version=1\&modificationDate=1559883725060\&cacheVersion=1\&api=v2\&width=850)

#### Click on the blue "Create Loan Product" shown on the image above.

### **Details**&#x20;

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/32.png?version=1\&modificationDate=1442232040310\&cacheVersion=1\&api=v2\&width=953)

Note: All red colored asterisk mark are mandatory fields.

Please refer to the above **Details - Image**, Mentioned details below are updated with respect to the provided fields numbers.  &#x20;

1 - Provide **Loan Product name** .(Mandatory)&#x20;

2 - Provide **Short name**. (Mandatory)&#x20;

&#x20;3 - Provide description of this product.          &#x20;

4 - Select Fund source. Need to have defined required funds: [Manage Funds](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/organization/manage-funds.md).          &#x20;

5 - Provide Loan product Start date.         &#x20;

6 - Provide Loan product Close date. Note - Loan product cannot be used after this date.          &#x20;

7 - On checking the check box, it captures the number of loans taken by the customer.

### **Currency**&#x20;

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/40.png?version=3\&modificationDate=1442316475876\&cacheVersion=1\&api=v2\&width=960)

* 8 - Select **Currency** (Mandatory). Need to have defined required currency: [Currency Configuration](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/organization/currency-configuration.md)
* 9 - Provide **Decimal places** (Mandatory).&#x20;
* 10 - Provide **Currency in multiples of** (Mandatory). This is to provide total amount rounding off. For example: 10, so Total amount gets rounded off to 10's.&#x20;
* 11 - Provide I**nstallment in multiples of** (Mandatory). This is to provide installment rounding off. For example: 10, so Installment amount gets rounded off to 10's.&#x20;

### **Terms**

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/41.png?version=1\&modificationDate=1442317490666\&cacheVersion=1\&api=v2\&width=905)

**Section A: Defining Loan term for normal loan product.** Note: - If your loan product is based on Loan cycle - Jump to **Section B.**

* 12 - Provide **Principal** (Loan) amount, Default field is a mandatory field. Minimum and Maximum are optional fields wherein the loan amount cannot be provided beyond the min & max value.

&#x20;          Example: Minimum: 5000, Default: 10000 & Maximum: 15000. At the loan account level default values will be shown.&#x20;

* 13 - Provide **Number of repayments**, Default field is a mandatory field. Minimum and Maximum are optional fields wherein the number of repayments cannot be provided beyond the min & max value.

&#x20;          Example: Minimum: 5, Default: 10 & Maximum: 15. At the loan account level default values will be shown.&#x20;

* 14 - Provide **Rate of Interest**, Default field is a mandatory field. Minimum and Maximum are optional fields wherein the rate of interest cannot be provided beyond the min & max value.

&#x20;         Example: Minimum: 18, Default: 22 & Maximum: 24. At the loan account level default values will be shown.&#x20;

* 15 - Select **Per month** or **Per year** for Rate of Interest.&#x20;

&#x20;         Example: Per year.&#x20;

* 16 - Provide **Repaid Every** value

&#x20;         Example: 1&#x20;

* 17 - Select **Day** or **Week** or **Bi-weekly** or **Month**&#x20;

&#x20;         Example: Week

18 - This is an optional field. This could be used in case you want to set "Minimum days between disbursal and first repayment date".Example: 10 (Days), So if the loan disbursement is on January 1st and normal expected first repayment is on 8th January,If you are providing 10 days as minimum days between disbursal and first repayment date, the first repayment will happen on 11th Jan. Or**Section B:** If your loan product is based on Loan cycle.&#x20;

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/42.png?version=1\&modificationDate=1442324747381\&cacheVersion=1\&api=v2\&width=912)

19 - Check the check box to enable "**Terms vary based on loan cycle**".&#x20;

20 - Provide values in principal section. Click on Add button to define Principal by loan cycle.In the image above:&#x20;

21 - Equals - Loan cycle as 1 with Principal Default amount of 10000. (Had there been one more cycle, it could be defined as Equals - loan cycle as 2 with principal amount)&#x20;

22 - Greater than -  Loan cycle as 1 with Principal Default amount of 20000. Greater than should always be used for the last cycle.&#x20;

23 - Define Number of repayments by loan cycles in the same way. Then continue defining other steps from Section A - 14 to 18.&#x20;

### **Settings**

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/43.png?version=1\&modificationDate=1442821901586\&cacheVersion=1\&api=v2\&width=902)

* 24 - Select **Amortization**: Depending upon the type of amortization you practice, select one.  Equal Installments - All repayment amounts will be equal but the principal and interest amounts will vary with each repayment.            Or Equal Principal Payments - All principal amounts will be equal but the repayment and interest amounts will vary with each repayment.
* 25 - Select **Interest method**: Depending upon the type of interest method you practice, select one.Flat, For formula reference - [Flat interest calculation](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/loan-products/loan-product-fields/flat-interest-calculation.md) Or Declining Balance, For formula reference - [Declining Balance Interest Calculation](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/loan-products/loan-product-fields/declining-balance-interest-calculation.md)
* 26 - Select **Repayment strategy**: The repayment strategy determines the sequence in which each of the components is paid. For more information on Repayment strategies: [Loan Product Fields](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/loan-products/loan-product-fields.md) - Repayment strategy.&#x20;
* 27 - Select **Interest calculation period**: Daily - Will Calculate the interest on DAILY basis example: Month of February has 28 days and it will calculate interest for 28 days, Or SAME AS REPAYMENT PERIOD - it calculates for the month, that is, 30 days.         &#x20;
* 28 - Provide Moratorium (Optional):&#x20;
* * On Principal Payment is '6' and the client's Repayment Frequency is every month, then for the first six months, the client has to pay Interest only and after six months the client starts paying principal amount too.
  * On Interest Payment is '6' and the client's Repayment Frequency is every month, then for the first six months, the client has to pay Principal only and after six months the client starts paying Interest amount too.
  * 29 - Provide Interest free period (Optional): If the Interest Free Period is '4' and the client's Repayment Frequency is every week, then for the first four weeks the client need not to pay interest, he has to pay principal due for that week only.          &#x20;
* 30 - Provide Arrears tolerance (Optional): With 'Arrears tolerance' you can specify a tolerance amount and if the loan is behind (in arrears), but within the tolerance, it won't be classified as 'in arrears' and part of the portfolio at risk.
* 31 - Select **Days in year**: Depending upon your organizations financial days select accordingly.

  &#x20;                 Actual - Will consider number of days with respect to actual calendar. Or 360 days Or 364 days Or 365 days.  &#x20;
* 32 - Select **Days in Months:** Depending upon your organizations financial practice select accordingly.&#x20;

  &#x20;                 Actual - Will consider number of days with respect to actual calendar. Or 30 days.          &#x20;
* 33 - Provide "Allow fixing of installment amount" (Optional): On checking the check box it enables providing the installment amount manually at the loan account level.                   Example: If the repayment amount every installment is 107 and you want to it to be 105. On providing 105 amount manually, it automatically adjusts the schedule for all the repayments.          &#x20;
* 34 - Number of days a loan may be overdue before moving into arrears (Optional): [Loan Product Fields](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/loan-products/loan-product-fields.md)         &#x20;
* 35 - Maximum number of days a loan may be overdue before becoming a NPA - non performing asset (Optional): [Loan Product Fields](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/loan-products/loan-product-fields.md)           &#x20;
* 36 - Account moves out of NPA only after all arrears have been cleared?: On checking the check box, Loans which are NPA will only move out of NPA only after all arrears have been cleared.          &#x20;
* 37 - Principal Threshold (%) for Last Installment:&#x20;

### Interest Recalculation

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/44.png?version=1\&modificationDate=1442831822668\&cacheVersion=1\&api=v2\&width=918)

38 - On checking the check box for "Recalculate Interest" - It will enable Interest recalculation. For more information on Interest recalculation refer - [Interest Amount Recalculation for Loan Accounts](http://mifosforge.jira.com/wiki/spaces/MIFOSX/pages/70910144/Interest+Amount+Recalculation+for+Loan+Accounts).&#x20;

#### Guarantee Requirements

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/45.png?version=2\&modificationDate=1442837632312\&cacheVersion=1\&api=v2\&width=1088)

39 - On checking the check box will enable "Place Guarantee Funds On-Hold".&#x20;

40 - Mandatory Guarantee (%): This is to provide total % of loan amount as mandatory guarantee. Example: 20 %.&#x20;

41 - Minimum Guarantee from Own Funds (%):\
Example: 10 % of loan amount from Own funds.&#x20;

42 - Minimum Guarantee from Guarantor Funds (%): Example: 10 % of loan amount from Guarantor Funds.

### Loan Tranche Details

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/46.png?version=1\&modificationDate=1442837650154\&cacheVersion=1\&api=v2\&width=1097)

**Note: If your loan product is tranche loan, then providing the details you could create product.**&#x20;

43 - Checking the check box will enable Multiple disbursal's.&#x20;

44 - Provide the maximum number of disbursements allowed for a loan account.&#x20;

45 - Provide maximum outstanding loan account balance at a point in time. &#x20;

### Configurable terms & settings&#x20;

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/47.png?version=1\&modificationDate=1442838357325\&cacheVersion=1\&api=v2\&width=823)

46 - By default "Allow overriding select terms and settings in loan accounts" is checked (Enabled). If you don't want to allow over ridding for the mentioned categories, then you could un-check the box.

### Charges

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/48.png?version=1\&modificationDate=1442838829716\&cacheVersion=1\&api=v2\&width=1089)

In order to use Add charge, you should have already defined it in charges. For more information on charges refer here: [Charges](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/charges.md)

### Overdue Charges

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/49.png?version=1\&modificationDate=1442839162535\&cacheVersion=1\&api=v2\&width=1083)

In order to use Add overdue charge, you should have already defined it in charges. For more information on charges refer here: [Charges](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/charges.md)

### Accounting&#x20;

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/50.png?version=1\&modificationDate=1442839539048\&cacheVersion=1\&api=v2\&width=1085)

**By default Accounting will be disabled - None:-** Meaning If you are using this product for various transactions like disbursement, repayment etc. These transactions are not passed in journal entry.  \
**Enabling accounting for the loan product**:->> You should have created chart of accounts, for info refer: [https://mifosforge.jira.com/wiki/display/docs/Chart+of+Accounts+and+General+Ledger+Setup](/mifosx/user-manual/for-administrators-mifos-x-platform/accounting/chart-of-accounts-general-ledger-setup.md).>> To enable Accounting, you need to select either one of the account type below, depending upon your organization accounting practice. &#x20;

* Cash&#x20;
* Accrual (periodic)&#x20;
* Accrual (upfront) <br>

\>> Map accounts with respect to the loan product accounts. For information on these accounts refer: [A Possible accounting Spec](http://mifosforge.jira.com/wiki/spaces/MIFOSX/pages/25821280/A+Possible+accounting+Spec) - Accounting rules for loans

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/51.png?version=1\&modificationDate=1442897783948\&cacheVersion=1\&api=v2\&width=976)

**Advanced Accounting Rule**&#x20;

On clicking on the show button, it enables Advanced accounting rule.&#x20;

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/52.png?version=1\&modificationDate=1442898476639\&cacheVersion=1\&api=v2\&width=708)

If you click on Add button, it will expand and show up selection drop-downs.&#x20;

* Configure Fund sources for Payment Channels. \
  Example: In the shown image above, Payment type - Cheque is mapped to Fund source - Bank. So whenever payment type is used for transaction, journal entry for Account - Bank will be passed.&#x20;
* Map Fees to Income Accounts.&#x20;
* Map Penalties to Specific Income Accounts.

**Click on Submit button to Save/Create loan product.**

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/53.png?version=1\&modificationDate=1442899049294\&cacheVersion=1\&api=v2\&width=128)

### View Loan Product&#x20;

&#x20;Go to Admin>>Product>>Loan Products

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/54.png?version=1\&modificationDate=1442901251813\&cacheVersion=1\&api=v2\&width=908)

In the image above showing Loan products list.&#x20;

### Edit Loan Product

Go to Admin>>Product>>Loan Products>>Select loan product (Example: Agriculture loan) >> then click on Edit button.&#x20;

![](https://mifosforge.jira.com/wiki/download/thumbnails/102039585/55.png?version=1\&modificationDate=1442901798454\&cacheVersion=1\&api=v2\&width=929)

In the image above, View - Loan products details as well as you can Edit Loan product.

Mifos X provides the ability to restrict loan account holding combinations not allowed by a financial institution. Use the [Product Mix](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/loan-products/product-mix.md) capability to define your financial institutions restrictions.&#x20;

{% hint style="warning" %}
A loan account is a specific instance of a loan product, with a specified interest rate and an account number, and it is owned by a financial institution client.
{% endhint %}

Related articles

* Page:[Savings Products](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/untitled.md)
* Page:[Loan Products](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/loan-products.md)
* Page:[Share products](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/share-products.md)
* Page:[Fixed Deposit Products](/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/fixed-deposit-products.md)
* Page:[Loan with term vary based on loan cycle](/mifosx/user-manual/for-operational-users-mifos-x-web-app/accounts-and-transactions/loan-accounts/loan-with-term-vary-based-on-loan-cycle.md)


---

# 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.mifos.org/mifosx/user-manual/for-administrators-mifos-x-platform/administration/products/loan-products.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.
