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 |
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 |