Skip to main content

Mortgage File - Documents Tab

Everything you need to know to navigate the Documents Tab within a mortgage File.

Written by Jarrett White

This document covers every button, workflow, and feature in the Documents tab of a mortgage file. It is intended for use by Intercom support agents and team leads.

Sections Covered

  • 1. Sticky Top Bar — Always Visible

  • 2. Documents Page Toolbar

  • 3. Requesting Documents from a Client

  • 4. Document Templates & Batches

  • 5. Sending a Document Request to the Client

  • 6. Managing Uploaded Documents

  • 7. Auto Reminders

  • 8. Generating & Sending Letters

  • 9. The Client Portal — Document Experience

  • 10. Troubleshooting — Email Not Sending

  • 11. Quick Reference Table

1. Sticky Top Bar — Always Visible

The sticky top bar appears at the top of every tab within a mortgage file, including the Documents tab. It does not change regardless of which section you are viewing.

Back

Navigate back to the pipeline

Title

The name/title of the mortgage file

Loan code

The associated loan code for this file

Borrowers

Names of the borrower(s) on the file

Amount of finance

The mortgage amount

Closing date

The file's closing date

Actions dropdown

A dropdown with quick actions for this file (see below)

Actions Dropdown Options

Pull from Velocity

Re-sync this file's data from Velocity

View client portal

Open a preview of the client portal for this file

Copy portal link

Copy the portal link to share directly with the client

Email

Send an email to the client from within the system

Gift request

Send a gift request to the client

Document reminder

Manually send a document reminder to the client

Mark complete

Move the file to the Completed tab in the pipeline

Mark archived

Move the file to the Archived tab in the pipeline

2. Documents Page Toolbar

The Documents page has its own toolbar at the top of the tab, below the sticky bar. Each button is described below from left to right.

Search Documents

  • Searches across all documents on the file by name or type.

Filter by Status

  • Filters the document list by status.

  • Available statuses: Pending, Approved, Rejected.

Portal Access Toggle

  • Revokes or restores the client's access to their portal for this file.

  • Use this if you need to cut off a client's ability to view or upload documents.

Grid / List View Toggle

  • Switches the document display between a grid (card) format and a flat list format.

  • List format is useful for files with many documents — easier to scan and manage.

Auto Reminders

Opens the auto reminder configuration. See Section 7 for full details.

Generate Letter

Generates a branded PDF letter (e.g. pre-approval letter) using your saved letter templates.

  • Requires letter templates to be created first in Settings.

  • After generating, two buttons appear: View Letter (preview the PDF) and Send Letter (send directly to the client and/or realtor).

📍 Settings → Client Experience → Letter Templates

Request Documents (Blue Button)

The primary button for requesting documents from a client. Opens the document request module. See Section 3 for full details.

Send Requests (Next to Request Documents)

Opens the document reminder/send module to actually deliver the document request to the client via email. See Section 5 for full details.

⚠ Clicking 'Request Documents' and creating a request does NOT send anything to the client. You must click 'Send Requests' separately to notify them.

3. Requesting Documents from a Client

The document request workflow has two distinct steps: (1) adding items to the client's portal queue, and (2) sending the client a notification. These are separate actions.

Step 1 — Open the Request Module

  • Click the blue Request Documents button in the Documents toolbar.

  • This opens the document request module, which shows all your saved document templates on the left column.

Step 2 — Select or Create Document Requests

Using an Existing Template

  • Browse or search your templates in the left column.

  • Use the search bar at the top of the template list to find a specific template quickly.

  • Use the categories filter to narrow by document category.

  • Use the folders button to filter by folder if your templates are organized into folders.

  • Click a template to add it to the request queue.

Creating a Custom Request (No Template)

  • Click the Document Request button at the bottom of the module.

  • Enter a title (e.g. 'Recent Pay Stub').

  • Enter a description (e.g. 'Most recent two pay stubs required').

  • Toggle Save for Future Use to automatically save this as a template for next time.

  • The item is added to the request queue.

Using a Batch

  • Click the Batches tab at the top of the template panel (next to Templates).

  • Select a pre-built batch (e.g. 'All Employee Documents') to add all items in that batch to the queue at once.

  • Batches are created and managed in the Templates section. See Section 4.

⚠ You must select the borrower at the top of the request module before adding items. Documents will be organized under the selected borrower's name. If there are multiple borrowers, select each one and add the documents relevant to them.

Step 3 — Create the Request

  • Once all desired documents are in the queue, click Create Request.

  • The items are now added to the client portal — they appear in the portal under the borrower's name.

  • Documents requested from different borrowers appear under each borrower's name separately.

This does NOT send any notification to the client. To notify them, proceed to Section 5 — Sending a Document Request.

4. Document Templates & Batches

Document templates and batches save time by letting you pre-build commonly requested document sets. They are managed in the Templates section on the sidebar.

Document Templates

📍 Templates section → Document Templates

What you can configure on a template

Title

The name of the document being requested (e.g. 'Letter of Employment')

Description

Instructions shown to the client about what to upload

Sample document

An example file the client can view in their portal — helps them understand exactly what to upload. A 'View Sample' button appears next to the request in their portal.

Category / Folder

Organize templates for easier searching and filtering in the request module

Best practice: Build your template library gradually by using the 'Save for Future Use' toggle when making custom requests. Over time, you will accumulate a full library without needing to create everything upfront.

Document Batches

Batches group multiple templates together so you can request them all at once with a single click.

📍 Templates section → Document Batches

  • Create a batch with a name (e.g. 'All Employee Documents').

  • Add the relevant document templates to the batch (e.g. Letter of Employment, Pay Stub, T4, Photo ID).

  • In the request module, switch to the Batches tab and select the batch to add all items to the queue instantly.

5. Sending a Document Request to the Client

After creating a document request (adding items to the portal), you need to separately send the client a notification. This is done through the Send Requests module.

Opening the Send Module

  • Click the Send Requests button in the Documents toolbar (next to the blue Request Documents button).

  • This opens the document reminder/send module.

Configuring the Send

Recipient

Select the borrower from the left side. This automatically pulls all outstanding document requests for that borrower into the send list. Any approved documents are automatically excluded.

Document list preview

A branded visual template showing the client's name and all outstanding documents is generated automatically.

Custom message

Scroll down on the left panel to add a custom message. This appears at the top of the email above the document list.

Email templates

Select from your saved email templates to auto-fill the custom message field — no need to type it out each time.

CC team members

Quick-add CC recipients from your team.

BCC

Add blind CC recipients if needed.

Email signature

Choose from different email signatures if multiple are configured.

Sending email

Select which connected email address to send from (useful for teams where multiple people have email connected).

Send from

Toggle to send the email as another team member — select from the list of available team members.

Sending

  • Once configured, click Send Reminder in the bottom right corner to deliver the request to the client.

  • The client receives a branded email with their portal access button, a list of all outstanding documents, and your custom message.

  • The email is styled using your email signature and company brand colors.

As clients upload documents and those documents get approved, they are automatically removed from the send list the next time you open the module. The list gets shorter over time as the file progresses.

6. Managing Uploaded Documents

Once a client uploads documents, they appear in the Documents tab highlighted in red (pending review). You have several tools to review, organize, and manage them.

Per-Document Actions

Click on any document to access these options:

Preview

Open and view the document in the preview module without downloading

Download

Download the document to your device

Upload more

Add additional documents to this same request item

Convert to PDF

Convert the document to PDF format

Approve

Mark the document as approved — removes it from the outstanding request list

Flag / Reject

Reject the document and optionally add a rejection reason (e.g. 'Incorrect document', 'Image too blurry'). The rejection notice appears in the send list the next time you send a reminder, so the client sees exactly what was wrong.

Delete (trashcan)

Permanently delete the document from the file

Moving Documents Between Requests

  • If a client uploads a document to the wrong request slot, simply drag and drop it to the correct request item.

  • No other steps required — it reorganizes instantly.

Mass Actions

Select one or more documents using the checkbox on the left side of each document. Once selected, the mass actions bar appears.

Select all / Deselect all

Available in the mass actions row once at least one document is selected

Approve all

Approve all selected documents at once

Approve and rename

Approves selected documents and automatically renames them to match the request title (e.g. 'Client Name - Letter of Employment'). You can then click the title to edit it further if needed.

Reject all

Reject all selected documents at once

Analyze / Analyze AI

Future feature — AI-assisted document analysis for income verification and down payment verification. Currently in prototype stage — disregard for now.

Export

Export selected documents

Compress

Compress selected documents into a smaller file size

Merge PDF

Merge multiple selected documents into a single PDF

Splitting a Document

  • Open the document in the preview module.

  • All pages appear as thumbnails in the left column.

  • Select the checkboxes on the pages you want to split out.

  • Click Split Document to separate those pages into their own document.

Useful when a client scans multiple documents together into one file — you can split them into separate, correctly labeled documents.

7. Auto Reminders

Auto reminders automatically send document request emails to clients at a set frequency without you needing to manually send them each time.

Setting Up Auto Reminders

  • Click the Auto Reminders button in the Documents toolbar.

  • Choose a frequency: Daily, every 2 days, 3 days, 4 days, 5 days, 6 days, or Weekly.

  • Set the send time and time zone.

  • Write a custom message (recommended: keep it simple — e.g. 'Here are the outstanding documents required for your file.').

  • Choose whether to send to all borrowers on the file or a specific borrower.

  • Click Enable / Initialize to activate.

Best practice: After manually sending the first document request, enable auto reminders at a 2–3 day frequency. If the client becomes unresponsive, simply turn the auto reminders off.

  • As documents get approved, they are automatically removed from the reminder list — clients only receive reminders about what is still outstanding.

  • To stop reminders, open the Auto Reminders panel and disable them.

8. Generating & Sending Letters

The letter generation feature allows you to create a branded PDF letter (such as a pre-approval letter) directly from within the mortgage file.

Setting Up Letter Templates

📍 Settings → Client Experience → Letter Templates

  • Add your name, email, position, and phone number.

  • Upload your signature.

  • Create letter templates for different scenarios.

Best practice: Create one template for male clients (e.g. 'He is pre-approved...'), one for female clients (e.g. 'She is pre-approved...'), and one for couples or non-binary clients (e.g. 'They are pre-approved...'). This way the correct language is already in the template and no editing is needed.

Generating a Letter

  • Click the Generate Letter button in the Documents toolbar.

  • Select the appropriate template from your saved templates.

  • Fill in any variable fields (e.g. property address, approved amount, additional notes).

  • Click Generate PDF.

  • A branded PDF is created with your signature, branding, and the filled-in details.

After Generating

View Letter

Preview the generated PDF

Send Letter

Send the PDF directly to the client and/or realtor — select recipients and send from the modal

9. The Client Portal — Document Experience

The client portal is where clients view their document requests and upload their documents. It is accessible via a link you share with them, and is fully branded to your company colors and settings.

Viewing the Portal

  • Click View Client Portal from the Actions dropdown in the sticky top bar, or copy the portal link to send to the client directly.

  • The portal shows the client's document requests organized by borrower name.

  • Each request shows the title and description you configured.

  • If a sample document is attached to the template, a View Sample button appears next to the request.

Client Upload Experience

  • The client clicks on a request and uploads their document.

  • Uploaded documents show as 'Under Review' in the client portal until you approve or reject them.

  • Clients cannot download or preview documents they have already uploaded — this is intentional for security purposes.

  • Clients cannot delete documents they have already uploaded — also intentional, to prevent accidental removal of documents you may need.

  • Clients do not need to create an account to access the portal — the link grants direct access, removing a friction barrier.

After the Client Uploads

  • You receive an email notification whenever a client uploads a document.

  • The document appears in the Documents tab highlighted in red (pending review status).

  • Use the approve, reject, or flag options to process the upload. See Section 6.

  • Rejected documents show the rejection reason in the client's portal and in your next send reminder list.

10. Troubleshooting — Email Not Sending

If a client reports they are not receiving document request emails, or if the system is not sending, follow this checklist.

Check Email Integration

  • The most common cause: the user's email is not connected or is connected incorrectly.

📍 Settings → Integrations → Email Integrations

  • Check that Gmail or Outlook is connected.

  • If Gmail appears connected but emails are still not sending: disconnect it and reconnect.

  • During the Gmail reconnect flow, ensure the 'Allow sending emails' checkbox is toggled on — this grants the system permission to send on the user's behalf.

⚠ If the 'Allow sending emails' permission is not granted during the Gmail sign-in flow, the system will not be able to send emails even if the integration appears connected.

Other Checks

  • Verify the client's email address is correct on the file.

  • Ask the client to check their spam/junk folder.

  • Confirm the correct sending email and signature are selected in the Send Requests module.

11. Quick Reference — Where Is That Button?

Button / Feature

Location

What it does

Sticky top bar

Top of every file tab

File info + quick actions dropdown always visible

Actions dropdown

Sticky top bar, right side

Pull from Velocity, view portal, email, gift, reminder, mark complete/archive

Search documents

Documents toolbar

Search documents by name or type

Filter by status

Documents toolbar

Filter to Pending / Approved / Rejected

Portal access toggle

Documents toolbar

Revoke or restore client portal access

Grid / List toggle

Documents toolbar

Switch between card grid and flat list view

Auto reminders

Documents toolbar

Set up automated recurring document reminder emails

Generate letter

Documents toolbar

Create a branded PDF letter from a template

View letter

Next to Generate Letter (after generating)

Preview the generated PDF

Send letter

Next to Generate Letter (after generating)

Send the letter to client and/or realtor

Request documents (blue)

Documents toolbar

Open the document request module

Send requests

Documents toolbar, next to Request Documents

Open the send module to notify the client

Document Request (bottom of module)

Inside the request module

Create a custom one-off document request

Save for future use toggle

Inside the custom request form

Save the custom request as a reusable template

Batches tab

Inside the request module

Switch from templates to batch requests

Create request

Bottom of the request module

Add items to the client portal (does not send email)

Send reminder

Bottom right of the send module

Send the document request email to the client

Approve (per document)

Document action buttons

Mark the document as approved

Flag / Reject

Document action buttons

Reject with an optional reason

Delete (trashcan)

Document action buttons

Permanently delete the document

Merge PDF

Mass actions (select 2+ docs)

Merge selected documents into one PDF

Split document

Inside the preview module

Split pages of a multi-page document into separate files

Approve and rename

Mass actions

Approve and auto-rename to match request title

View client portal

Actions dropdown in sticky bar

Preview the portal as the client sees it

Copy portal link

Actions dropdown in sticky bar

Copy the link to share with the client

Did this answer your question?