> ## Documentation Index
> Fetch the complete documentation index at: https://help.leaf360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Loans

> The loan pipelines in Leaf360 Mortgage CRM: how a loan gets in, what the stages are, how to move one along, and what a loan record holds.

Loans is where a deal lives once it's a file rather than a lead. Each loan pipeline is a list you can filter, sort and act on in bulk, plus a board split by stage where you drag a card to move it along.

Open it from **Loans** under **Pipelines** in the sidebar. There's no single Loans page: the sidebar row expands into the pipelines your company has set up, and each one opens its own list.

Out of the box the rows are **All Loans**, **Applications**, **Pre-Approved**, **Processing** and **Closings**. The browser tab reads **All Loans**, **Loan Applications**, **Pre-Approved Loans**, **Processing Loans** and **Closing Loans** in turn. Where your company added a pipeline of its own, its row appears alongside these and its tab reads **Loans: {name}**.

<Note>
  Loans and leads are separate records. A lead lives on [Sales Pipeline](/mortgage-crm/sales-leads); a loan lives here. Each sidebar row carries its own count, and the counts reflect the whole pipeline rather than just the rows on your screen.
</Note>

## The header

The pipeline name sits at the top left with an arrow beside it, colored to match the pipeline. Click it to open a dropdown of every pipeline your company has set up, each with its color dot and description, and **All Loans** first.

To the right of the name are two numbers, the count of **loans** and the total **volume**. Two icon buttons finish the row:

| Icon   | Tooltip          | What it does                             |
| ------ | ---------------- | ---------------------------------------- |
| Plus   | **Create Loan**  | Opens the loan creation form             |
| Upload | **Import Loans** | Opens the same window on its import side |

## How loan amounts are written

A loan amount in the table is written as whole US dollars with thousands separators and no cents, so a loan of two hundred and sixty thousand shows as `$260,000`. Cents are rounded away rather than shown, and the same rule covers every currency column on the list, including the currency custom fields your company defined.

The **volume** figure in the page header is the exception. It's written out to two decimal places.

Amounts typed into a field are read back the same way, so a figure pasted in with commas and a decimal is understood rather than rejected.

## How a loan gets into the pipeline

Both routes start from the same window, headed **Import Loan Applications**, with two buttons at the top: **Create New Loan** and **Import Loan Data**.

### Creating one by hand

**Create New Loan** is a five-step form: **Borrower Info**, **Loan Details**, **Property**, **Employment** and **Review**. Fields marked with an asterisk are required.

* **Borrower Info** takes the borrower's name, email, phone numbers, birth date, marital status and dependents, and opens a co-borrower block when you need one.
* **Loan Details** takes a **Loan Title**, the loan amount, interest rate, loan program, purpose, term, monthly payment, LTV, and the estimated and actual close dates.
* **Property** takes the address, city, state, zip and county, the property type and occupancy, the estimated property value and the purchase price.
* **Employment** takes the employer, job title and monthly income.
* **Review** shows everything back to you before you commit.

Where a company has an LOS connected, the form also offers to sync the new loan across once it's saved, and tells you separately whether the loan was created and whether the sync went through.

Opening the form from the plus in a board column header pre-selects that column's first status, so the new loan lands where you started.

### Importing several

**Import Loan Data** offers two methods, **CSV Import** for bulk loan data and **MISMO Import** for XML files.

The CSV route runs in four steps, shown as a strip across the top: **1. Upload**, **2. Analyze**, **3. Map Fields** and **4. Preview & Import**. Leaf360 reads your headers, proposes a mapping, and lets you correct it before anything is written. A sample CSV is available to download from the upload step. Very large files are handled by Leaf360 itself, so a large upload won't slow down your computer.

The import reports back in detail: how many loans were created, how many rows failed, how many were skipped because the loan officer named on the row couldn't be found, and how many rows carried a date it couldn't read and left blank.

<Note>
  Leads are imported somewhere else entirely. See [Import Data](/mortgage-crm/import-data) for the borrower and contact importers.
</Note>

## What the stages are

A pipeline is a set of stage columns, and each column gathers one or more of your company's loan statuses. The mapping belongs to your company and is edited under **Loan Pipeline** in Settings; see [Pipeline Stages](/mortgage-crm/pipeline-stages).

The stage names Leaf360 ships with look like this:

| Pipeline     | Stages                                                                                                                               |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| Applications | **Apps Pending**, **Applied**, **Docs Received**, **Ready to Review**, **Long Term Followup**                                        |
| Processing   | **File Setup**, **Disclosed**, **Signed**, **Review**, **Submitted to UW**, **Conditional Approval**, **Resubmitted**, **Suspended** |
| Closings     | **Cleared to Close**, **Docs Out**, **Docs Signed**, **Funded**, **Completed**                                                       |

<Note>
  Read the table as a starting point, not as what you'll see. The live columns always come from your company's saved setup, which an administrator can rename, reorder, add to and remove from. The **Pre-Approved** pipeline in particular is often grouped by how far off the borrower is rather than by loan status, so its columns are left out of the table above. The authoritative list is the one in **Settings**, then **Loan Pipeline**.
</Note>

Each stage also carries a one-line description, shown under its name in the board column header. Conditional Approval reads **Conditions issued**, for instance, and Long Term Followup reads **Missing Credit, Income, Assets or not Ready**.

**All Loans** has no stages. It's one flat list of every loan in the pipeline, which is why it has no board and no focus bar.

## List view and board view

On any pipeline other than All Loans, **List View** and **Kanban View** sit in a muted bar under the header. Which one opens first is your own saved preference, set under **Pipeline View** in Settings, so it follows your account rather than this computer. Switching by hand only lasts for the visit.

**All Loans** is list only, and the toggle isn't shown there at all.

### The focus bar

Above the search box on every pipeline except All Loans is a row of buttons: **All Loans** first with the pipeline total, then one button per stage carrying that stage's count. Select one to narrow the table to the loans in that stage. The counts are the real totals across the whole pipeline, not a count of what's on screen.

## Working the list

<Steps>
  <Step title="Search">
    **Search by name, email, or phone...** at the top left searches the whole pipeline, not just the page in front of you.
  </Step>

  <Step title="Filter by column">
    Click a column title and a small box opens with that column's sort directions and, where the column supports one, its filter. Sort labels follow the column: **A → Z** and **Z → A** for text, **Low → High** and **High → Low** for numbers, **Oldest → Newest** and **Newest → Oldest** for dates. Value columns offer a checkbox list with a **Search...** box, number and date columns offer a range, and the communication recency columns offer relative windows such as **In the last 7 days**. Where several values are ticked, it tells you **Multiple selections match any**, because ticking more widens rather than narrows.
  </Step>

  <Step title="Read back what is applied">
    Active column filters show up as small tags next to the search box, each with an X, with a **Clear all** alongside them.
  </Step>

  <Step title="Narrow to one team member">
    The **Team Member** button limits the table to one person's loans, with an X beside it to clear. It's a paid feature, so on the free plan it isn't shown at all, and it's also absent when no other team members have loaded.
  </Step>
</Steps>

### Saved filters

**Smart Filters** stores the column filters you've applied under a name you give it. The button carries a count once you have any, and until then the menu reads **No saved filters yet.** and **Apply column filters then save them here.** Each saved set has a trash icon beside it, and **Save current filters** appears at the bottom of the menu once you have filters applied.

### Choosing your columns

**Columns** opens a searchable list with a checkbox per column and a counter showing what's visible. Drag the handle beside a row to reorder.

The columns you get out of the box cover the borrower and the file: Borrower, Email, Phone, Loan Amount, Stage, Priority, Progress, Property, FICO, Transaction Team, Application Date, Est. Closing, Days in Stage, Loan Type, Loan Product, Rate, Lock Exp., Conditions, Appraisal, Title and Referral Partner, plus any custom fields your company defined for loans.

LTV, DTI, Closing Variance, Purchase Price, Program/Channel, Lender, Submission Date, Underwriter, Next Milestone, Co-Borrower, Occupancy, Property Type, Hazard Ins., Notes and the Actions column all start hidden and can be switched on.

Beyond those sits a large opt-in set, grouped in the column picker under Communication, Team, Borrower, Loan Terms, Ratios, Property, Refinance, Dates, Loan Status Dates and Source. That's where the call, email and text recency columns live, along with mortgage type and loan purpose, base loan amount and qualifying rate, amortisation type and term, lien position and agency case number, CLTV and the two DTI figures, DSCR, total housing payment and HOA dues, appraised value and down payment, the property city, state, zip, county and unit count, the refinance and cash out fields, the milestone dates from App Intake through Loan Funded, the processor and closer names, and the pricing tier and marketing source. Every one of them starts hidden.

Your visible columns and their order are remembered on the computer you set them on.

<Note>
  Borrower SSN and date of birth are deliberately absent from the column set. They're encrypted on the record and aren't exposed as list columns.
</Note>

## Opening and contacting a loan

The borrower's name in the **Borrower** column is the link to the loan record. Clicking elsewhere on the row does nothing.

Two cells act on their own. The email cell opens the email composer for that borrower, and the phone cell opens the call and text box.

Right-clicking a row opens **Loan Actions**, with **Open loan**, **Open in new tab** and **Copy loan link**.

There's also an **Actions** column, which starts hidden. Switch it on from **Columns** and each row gains three icon buttons, labeled **Call**, **SMS** and **Email**, which open the caller, the text box and the email composer for that borrower, plus a three-dot menu carrying **View Details**.

## Moving a loan along

There are three ways, and all three write to the loan.

<Steps>
  <Step title="Drag a card on the board">
    Drop a card on another column and the loan takes that column's first status. The card moves right away, and moves back with an error if the change isn't accepted.
  </Step>

  <Step title="Click the Stage label on the list">
    The label in the **Stage** column opens a list of every loan status your company has, grouped under its pipeline stage. Any status is selectable, including a move backwards and a jump into another pipeline such as Withdrawn, and Leaf360 works out the destination pipeline from the status you picked.
  </Step>

  <Step title="Select rows and use Move to Status">
    In the bulk bar, **Move to Status** applies one status across the selection.
  </Step>
</Steps>

### When a status change is blocked

Your company can require checklist items to be finished before a loan reaches a given status. When one of those gates stops you, a dialog opens naming the status you tried to reach and listing every incomplete required item. Administrators get an override button, which asks for a written reason before it lets the move through.

On a bulk move, gated loans are counted separately and reported back so you know how many need opening individually.

## Acting on many loans at once

Tick a row, or the header checkbox to grab the whole page. A bar appears above the table saying how many are selected, with **Clear** to drop the selection and, where there's more than a page, **Select all {n} records**.

| Action              | What it does                                                   |
| ------------------- | -------------------------------------------------------------- |
| **Move to Status**  | Sets the loan status across the selection                      |
| **Bulk Email**      | Opens the bulk email composer with the selection as recipients |
| **Tags**            | Adds, removes or replaces tags across the selection            |
| **Power Dial**      | Starts a dialling session over the selection                   |
| **Add to Campaign** | Adds the selection to a campaign                               |
| **Export CSV**      | Exports the selection                                          |
| **Archive**         | Archives, and archived loans can be restored                   |
| **Delete**          | Deletes, administrators only                                   |

**Archive** stops for a typed confirmation and names the loans it's about to touch. With one loan selected you type that borrower's first name; with several you type `confirmed`. **Delete** asks you to type `delete`, and the button stays disabled until the text matches.

<Warning>
  **Delete** is only in the bar for administrators. Everyone else sees **Archive** and nothing beside it.
</Warning>

**Move to Status**, **Tags**, **Power Dial**, **Archive** and **Delete** act on the rows on the page you're looking at. Work a page at a time. **Bulk Email**, **Add to Campaign** and **Export CSV** cover every loan matching your filters, not just the current page.

### Exporting

**Export CSV** opens a small box saying how many loans will be exported, with an **Include custom fields** checkbox and an **Export CSV** button. The export is capped at ten thousand loans; past that, Leaf360 tells you to narrow your filters and try again.

## Pagination

**Rows per page** offers 10, 25, 50 and 100. A counter above the table shows which slice of the total you're on, the line at the bottom repeats it as **Showing X to Y of Z loans**, and first, previous, next and last buttons sit on the right. An empty table reads **No loans found.**

On the board, columns load a page at a time. Scroll to the bottom of a column and it loads more, showing **Scroll for more ({n} remaining)** and then **Loading {n} more...**. The header reads **{n} loaded** beside the total while there's more to come. An empty column offers an **Add Loan** button in the middle of it.

## What a loan record holds

Clicking through opens the loan record. The middle of the record is a row of tabs:

| Tab            | What it holds                                                                     |
| -------------- | --------------------------------------------------------------------------------- |
| **Loan**       | The file itself, covered below                                                    |
| **Notes**      | Notes on the loan                                                                 |
| **Emails**     | The email thread                                                                  |
| **Calls**      | Call history                                                                      |
| **Texts**      | The text thread                                                                   |
| **Tasks**      | Tasks attached to this loan                                                       |
| **Meetings**   | Scheduled meetings                                                                |
| **Documents**  | Documents on the file                                                             |
| **Checklists** | The checklists your company attached, including the ones that gate status changes |
| **Ask LIA**    | LIA, scoped to this loan                                                          |

The **Loan** tab itself is grouped into **Loan Details**, **Monthly Payment**, **Key Dates**, **Disclosure & Compliance** and **Combined Income**, with the borrower's employment, assets, real estate owned and credit liabilities each in their own block and each totaled. The status label at the top of the record opens the same status list the list view uses.

A left-hand column carries the borrower's compliance position at a glance: **Consent**, **DNC Status**, **SMS Opt-In** and **Phone Type**.

## Common problems

<AccordionGroup>
  <Accordion title="There is no board view on this pipeline">
    You're on **All Loans**, which is list only because it has no stages. Pick a specific pipeline from the name dropdown to get the board.
  </Accordion>

  <Accordion title="The stage names do not match what my colleague sees">
    Stages come from your company's own loan pipeline setup, and administrators can rename, reorder, add and remove them. See [Pipeline Stages](/mortgage-crm/pipeline-stages).
  </Accordion>

  <Accordion title="I selected everything but only some loans changed">
    Only **Bulk Email**, **Add to Campaign** and **Export CSV** widen to the full match. Everything else works from the loaded page.
  </Accordion>

  <Accordion title="A loan I expected is missing">
    Check the search box, the column filter tags, the team member filter and the focus bar, then check whether the loan has been archived. Archived and deleted loans both leave this list and turn up on [Archive Pipeline](/mortgage-crm/archive-pipeline).
  </Accordion>

  <Accordion title="My columns went back to the defaults">
    Column choices and column order are remembered on the computer you set them on. Saved sets under **Smart Filters** are stored on your account and do follow you.
  </Accordion>

  <Accordion title="The move was refused and a dialog listed checklist items">
    Your company gates that status behind a checklist. Finish the listed items on the loan, or ask an administrator to override with a reason.
  </Accordion>
</AccordionGroup>

## Related

* [Pipeline Stages](/mortgage-crm/pipeline-stages)
* [Archive Pipeline](/mortgage-crm/archive-pipeline)
* [SLA Management](/mortgage-crm/sla-management)
* [Credit Dashboard](/mortgage-crm/credit-dashboard)
* [Sales Pipeline](/mortgage-crm/sales-leads)
* [Leaf360 Mortgage CRM](/mortgage-crm/overview)
