> ## Documentation Index
> Fetch the complete documentation index at: https://docs.compuzign.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Create and manage loan products
> Create, edit, and archive the loan products your credit union offers, including code, loan type, rate source, amount and term limits, audience, per-product fees, minimum shares, and required supporting documents.
A loan product is a lending offering your credit union makes available to members: its code, loan type, rate source, and amount and term limits.
Credit Officers see only active products when creating a new loan application, so keeping your product list accurate directly affects what your team can originate. As a **Credit Manager** or **Administrator** you can create new products, update their parameters, or archive discontinued ones.
**Required role:** Credit Manager or Administrator (`loans.products.manage` capability). Viewing the product catalog and the new-application dropdown requires `loans.products.read` (read-only; the New, Edit, and Archive controls need `loans.products.manage`).
To access the product catalog, navigate to **Administration → Products**.
Create your loan types first. A product is built on top of a workspace-defined
loan type, so if no active loan types exist the product form shows the notice
"No loan types yet. Add one under Loan types first, then come back to create
this product.", and creation fails until you pick one. Set those up before
adding products.
Give every product a clear **name** that Credit Officers will recognize in
the new-application dropdown. The examples below such as "Civil Servant Go!"
and "Home Sweet Home Mortgage" are illustrative names; pick whatever fits
your own lineup. The **code** is the short internal identifier shown in the
product list and recorded in audit events.
## What a loan product contains
Each loan product is defined by these fields:
| Field | Description |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Code** | A short, unique internal identifier such as `CIVIL-GO` or `MORTGAGE-STD`. Uppercase letters, numbers, and dashes only, 2 to 20 characters. Shown in the product list and recorded in audit events |
| **Name** | The display name Credit Officers see in the new loan application dropdown, up to 80 characters |
| **Loan type** | The workspace-defined loan type this product belongs to, chosen from your Loan types catalog. Each loan type is bound to one behavioral archetype (Unsecured, Cash secured, Motor vehicle, or Real estate), which determines the PDF agreement template, collateral fields, and rate engine path |
| **Rate source** | How the interest rate is calculated for this product: FLAT, RISK\_BAND, COLLATERAL\_TYPE, or VEHICLE\_AGE. See [Rate Tables](/admin/rate-tables) for details |
| **Default rate** | For FLAT products, the fixed annual interest rate as a percentage such as `12.00` (0 to 100 percent). Not used for RISK\_BAND, COLLATERAL\_TYPE, or VEHICLE\_AGE products, where the rate is looked up from your rate table at approval time |
| **Minimum amount** | The lowest loan amount a Credit Officer can request for this product. Non-negative |
| **Maximum amount** | The highest loan amount a Credit Officer can request for this product. Non-negative |
| **Minimum term** | The shortest repayment period, 1 to 480 months |
| **Maximum term** | The longest repayment period, 1 to 480 months |
| **Description** | Optional. An internal note kept on the product record; not currently surfaced on the New Loan dropdown |
## The product sheet: audience, shares, fees, and documents
Beyond the basics above, each product carries the rest of its product sheet. These settings are all optional and live on the same New product and Edit product forms.
| Setting | What it does |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Audience** | Who the product is offered to: **General** (any member) or **Staff**. This is an eligibility label for grouping and filtering, not a loan type. A staff cash secured product, for example, keeps its true security basis (Cash secured) and is simply tagged Staff, so pricing and risk are unchanged |
| **Repayment method** | How the loan is repaid: Salary deduction, Over-the-counter payment, Automatic transfer, or Standing order. Tap all that apply. Recorded on the product sheet and shown to staff at capture |
| **Repayment frequency** | How often a repayment falls due: Weekly, Fortnightly, or Monthly. Reference information; the schedule is still calculated as a monthly-blended payment |
| **Minimum shares** | The share equity a member must hold for this product, as a percentage of the loan. When set, it overrides the loan type's minimum-shares rate for this product only, so two products under the same loan type can differ. Leave it blank to inherit the loan type's rate |
| **Compulsory savings** | The product's stated compulsory-savings minimum, for example JMD 2,000. Recorded for reference |
| **Approvals required** | How many approvers a loan on this product needs, for example 2 for approval by two adjudicators. Shown to Adjudication as policy guidance |
| **Applicable fees** | The fees that apply to this product. See "Setting fees per product" below |
| **Required supporting documents** | A checklist of the documents this product needs from the member, such as a job letter, recent payslips, or a valuation report. See "Required supporting documents" below |
| **Product specifications** | Free-form rows (a label and its details) for anything else on the product sheet: loan purpose, target market, special terms, risk notes, and so on. Descriptive only |
The repayment, approvals, compulsory-savings, and specifications settings are
recorded as product-sheet information. They are shown to staff on the loan;
they do not change how a loan is priced or how the workflow gates.
### Setting fees per product
By default a product uses the fees configured for its loan type on the [Fees](/admin/fees) page. When you want a product to differ, add per-product fee rows on the product form:
* **Opt a product into specific fees.** Pick a fee from your fee schedule to attach it to this product.
* **Override the amount.** Enter a different value for this product only. A percentage fee takes a percent, a flat fee takes a JMD amount. Your fee schedule keeps its original value.
* **Waive a fee.** Keep the fee on the sheet for the record while contributing nothing to the total.
When a product has one or more fee rows, those rows are its fee set. When it has none, the product falls back to the fees configured for its loan type, exactly as before. New fees themselves are still created on the [Fees](/admin/fees) page, where each fee also carries its GL account and tax treatment; the product form only chooses which of those apply and at what amount.
At disbursement, the Credit Officer sees these product fees pre-filled and can still edit or waive them per loan.
### Required supporting documents
Use this to record the supporting documents a product asks for, for example a completed application form, valid photo ID, a job letter, recent payslips, or proof of address. Add each as a row and mark it **Required** or **Recommended**. A one-click button inserts a standard set you can then adjust.
The list appears on the loan as a checklist so the Credit Officer knows what to collect. The documents themselves are uploaded in the member and income document cards on the loan, using the existing upload tools.
## Finding products in the catalog
The Products page lists your products with a search box (by code or name), a loan-type filter, a rate-source filter, and **All / Active / Archived** status tabs that each show a count. Each row shows how many applications have used that product (rows with no applications yet show no count), so you can tell active offerings from dormant ones at a glance. The list pages 20 at a time with a **Load more** button.
## Creating a product
A product is built on a loan type from your Loan types catalog. If none are
active, set one up under **Administration → Loan types** first. See
[Loan types](/admin/loan-types).
The Products page lists all active and archived products for your workspace.
The new product form opens.
The **code** is a short internal identifier such as `CIVIL-GO` or
`MORTGAGE-STD`. It must be unique within your workspace, can contain only
uppercase letters, numbers, and dashes, and is 2 to 20 characters. The
**name** is what Credit Officers see in the dropdown.
Choose the loan type from your Loan types catalog. The product inherits that
type's behavioral archetype (Unsecured, Cash secured, Motor vehicle, or Real estate),
which drives the rate engine path, collateral fields, and PDF template.
Choose how this product's interest rate is calculated. If you select
**FLAT**, enter the fixed rate in the Default Rate field. For RISK\_BAND,
COLLATERAL\_TYPE, and VEHICLE\_AGE, the rate is looked up from your rate
table at loan approval time.
Enter the minimum and maximum loan amounts in JMD. Leave these blank if you
do not want to enforce limits for this product. The minimum cannot exceed
the maximum.
Enter the minimum and maximum repayment terms in months, each between 1 and
480\. For example, enter `12` and `60` for a one-to-five-year product. Leave
blank if you do not want to enforce term limits.
Enter a short description (up to 500 characters). This is an internal note
kept on the product record; it is not currently surfaced on the New Loan
dropdown.
Set the audience, repayment method and frequency, minimum shares,
compulsory savings, approvals required, per-product fees, and required
supporting documents as needed. See
[The product sheet](#the-product-sheet-audience-shares-fees-and-documents)
above. All of these are optional and can change later.
The product is created and immediately appears in the new loan application
dropdown for Credit Officers.
## Editing a product
To update an existing product:
1. Go to **Administration → Products**.
2. Find the product and click its row, or use the **Edit** button on the row, to open the edit form.
3. Update the fields you want to change, then click **Save changes**.
Every field is editable, including the loan type and rate source. Changing the loan type re-points the product to a different archetype, so do it deliberately. Existing loan records read the product fields live, so an edited name, code, or limit appears on loans already using the product. Any loan not yet approved is priced at approval against the edited rate source and rate. The requested amount and term captured on each application are unchanged, and the interest rate is locked only once it has been computed at approval. Each save records a `loan_product.updated` audit event.
The new loan application form shows only active (non-archived) products.
Archive discontinued products to keep the dropdown clean for Credit Officers.
## Archiving and restoring a product
When your credit union stops offering a product, archive it rather than deleting it. Archiving hides the product from the new loan application dropdown without affecting any existing loans that used it.
**To archive a product:**
1. Go to **Administration → Products**.
2. Find the product and click **Archive**.
The product moves to the **Archived** tab. It no longer appears to Credit Officers. Archiving records a `loan_product.archived` audit event.
**To restore an archived product:**
1. Go to **Administration → Products** and open the **Archived** tab.
2. Find the product and click **Restore**.
The product becomes active again and reappears in the new loan application dropdown. Restoring records a `loan_product.restored` audit event.
Archiving only prevents new applications from being created with that
product. Archived and edited products stay linked to their loans (the
relation is restricted, so an in-use product cannot be deleted) and remain
visible on those loan records. There is no versioned product snapshot: the
displayed product fields reflect the current product values. The requested
amount and term captured on each application are unchanged, and the interest
rate is locked only once it has been computed at approval, so a loan still in
progress re-prices at approval against the current product.
## Rate sources at a glance
| Rate source | Best for | How the rate is determined |
| -------------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **FLAT** | Simple fixed-rate products | The rate you enter on the product is applied to every loan |
| **RISK\_BAND** | Unsecured and mortgage loans | Looked up from your rate table based on the borrower's R1 to R5 risk band. Mortgage products read a separate real-estate band table |
| **COLLATERAL\_TYPE** | Cash secured and collateral-rated loans | Looked up based on the collateral type (Vehicle, Shares, Cash hypothecation, Property) |
| **VEHICLE\_AGE** | Auto loans | Looked up based on the vehicle's age in years |