Setting up loan document folders

Prev Next

Being switched on account by account. If Loan Document Folders is not in your Account Settings yet, it has not been activated for your environment — ask your administrator to request it rather than raising a fault.

Loan document folders decide where a document on a loan is stored and which loan roles can see or upload it. Administrators manage them in Account Settings → Loan Document Folders. This is the reference for setting them up; for picking a destination when you upload, see Choosing a folder when uploading documents.

What a folder is

Every document on a loan sits in a folder. Each folder has:

  • Folder Name — unique in your account, up to 250 characters. It should match the matching bucket name in your LOS.
  • Status — Active or Inactive. Nobody can upload into an inactive folder.
  • Type — System Default (built in with your account) or Custom (created by you or your team).
  • Permissions — a list of loan roles, each with an Access Level and a Read Scope.

Access level and read scope

Access Level controls what a role can do:

Access Level What the role can do
Read View and download documents in the folder
Write Upload into the folder, plus everything Read allows
Not listed Nothing. A role you do not add has no access at all

Read Scope controls how much of the folder they see:

Read Scope Which documents the role sees
All Every document in the folder
Own Only documents that user uploaded, or documents on a task assigned to them

The two work together. A borrower set to Write / Own can upload to the folder but sees only their own uploads. A loan officer set to Write / All can upload and also sees everyone's documents.

Roles you can grant

Borrower, Co-Borrower, Non-Borrower, Loan Officer, Loan Processor, Loan Officer Assistant, Supporting Loan Officer, Buyer Agent, Seller Agent, Title Insurance Agent, Escrow Agent, Settlement Agent, and Admin. Account administrators are always treated as Admin.

Where the folders already in your list came from

You will not start with an empty list. Folders were created from several sources:

Source What it created Type Status
Built-in folders The 17 standard folders every account gets — Borrower Portal Document Vault, Partner Portal Document Vault, Settlement Agent Vault, EConsent, Credit Report, POS Documents - PreApprovals and so on System Default Active
Standard document requests One folder for each of the 23 standard "POS - …" buckets used by the built-in document request rules. The full list is further down Custom Active
Your existing tasks and templates One folder for every bucket name your tasks, task templates and document templates were already using. Those are now linked to the matching folder Custom Active
A new name typed on a task or template An administrator entering a bucket name that does not exist yet creates a folder with that name Custom Active
Documents synced from your LOS A document arriving from your LOS in a bucket the POS does not have yet creates a folder with that name Custom Inactive, no permissions
Account Settings Folders added with Add Folder Custom Active

Matching is by name and ignores capitalisation, so the same bucket name never produces two folders.

Creating a folder

  1. Go to Account Settings → Loan Document Folders and click Add Folder.
  2. Enter a Folder Name.
  3. Click Add Permission for each role that needs access, then set its Access Level and Read Scope. Each role can appear only once.
  4. Click Save.

A new folder has no permissions until you add them. Save it with none and nobody can see or upload to it — your own staff included. Give Loan Officer, Loan Processor, Loan Officer Assistant, Supporting Loan Officer and Admin Write / All on every folder unless you have a specific reason not to.

Editing a folder

  • Permissions can be changed at any time, on any folder, System Default folders included.
  • Names lock once any document or task has used the folder, and you will see a notice saying so. System Default folder names can never be changed.
  • Tasks stay uploadable. If removing a role's Write access would leave an existing task with nowhere to upload, the save is blocked and the affected tasks are listed for you.

Deactivating a folder

Deactivating stops new documents going into a folder but keeps everything already in it. Use the folder's actions menu and choose Deactivate. Once it is inactive:

  • No new uploads. Nobody, borrowers included, can upload into it — this applies even to an upload screen or task somebody already has open.
  • It cannot be selected. It stops appearing as a choice for new tasks, task templates, document templates and generated documents. Where it is still shown anywhere, it is labelled "(inactive)".
  • Existing documents stay put. Anyone whose permissions allow it can still view and download them.
  • A folder still in use needs a replacement. If tasks, task templates, document templates or business rules still point at it, you will be shown what is using it and must choose a New destination before it can be deactivated. Those items move to the new folder, which has to be active and let the affected roles upload. Documents already in the old folder are not moved — only the things that pointed at it.

Typical uses are retiring a folder you no longer want people uploading to, or getting rid of one that has been used and therefore cannot be deleted.

Reactivating and deleting

An inactive folder can be reactivated at any time, and uploads and selection start working again immediately.

Deleting is only possible for a folder that has never been used by a document, task or template, and it cannot be undone. For anything that has been used, deactivate instead.

System Default folders cannot be deactivated or deleted. You can still change their permissions.

What this changes day to day

  • Uploading — users are offered only the folders they have Write access to, so the list can be shorter than the full tree.
  • Document tasks — the task's folder must give Write access to the role the task is assigned to. The folder picker shows only folders those roles can upload to.
  • Loan officer warning — if a task's folder does not let the loan officer see every document, you get a warning and have to confirm before saving.
  • Documents in no folder — visible to loan staff. Borrowers and partners see only the ones they uploaded.
  • New buckets from your LOS — created Inactive with no permissions, so nobody can see those documents in the POS until an administrator reactivates the folder and adds permissions. Worth checking after any change at the LOS end.

Which folders appear on a loan

A user sees a folder on a loan only if they have at least Read access to it and one of these is true:

Folder Shown when empty?
Active System Default folder Yes, always
Active custom folder used by a task on that loan Yes
Any other custom folder No — it appears once it holds a document that user can see
Inactive folder No — it appears only while it still holds documents that user can see
Unassigned documents Only when there are documents that user can see

By default this means a borrower sees Borrower Portal Document Vault, POS Documents - PreApprovals, POS Documents - PreQualifications, EConsent and POS Documents - Credit Authorization on every loan, even when they are empty.

With Own scope, a user counts only the documents they can see. A folder holding nothing but a co-borrower's uploads looks empty to the borrower, so it is hidden from them unless one of the always-shown rules above applies. This is the usual explanation for "the folder has disappeared" — it has not, it is empty from where they are standing.

A folder a user can read but not upload to is shown as view only and is never offered as an upload destination.

Where borrowers can upload by default

Borrower, Co-Borrower and Non-Borrower get Write / Own on the following, so each person sees only what they uploaded:

  • Borrower Portal Document Vault — the only System Default folder borrowers can upload to.
  • The 23 standard "POS - …" folders: POS - All Additional Docs, POS - Assets, POS - Bank Statement, POS - Borrower Identification, POS - Business Tax Returns, POS - Current Mortgage Statement, POS - Current P&L/Balance Sheet, POS - Divorce Decree, POS - EMD, POS - Escrow Deposit Receipt, POS - Flood Insurance, POS - Homeowner's Insurance Policy & Paid Receipt, POS - Housing Bills, POS - Identification, POS - Income - Year End Paystubs, POS - Income Self-Employment Docs, POS - Insurance Policy, POS - Paystubs, POS - Retirement Income, POS - Sales Contract, POS - Social Security Income, POS - Tax Returns, POS - W-2/1099.
  • Folders created from your existing tasks and templates — one for each bucket name they were already using.
  • Folders created from a new bucket name typed on a task or document template.

Borrowers cannot upload to:

  • Any other System Default folder. They can only view four of them — POS Documents - PreApprovals, POS Documents - PreQualifications, EConsent and POS Documents - Credit Authorization — and have no access to the rest.
  • Folders created from documents synced from your LOS, which start inactive with no permissions.
  • Folders you create with Add Folder, unless you give the borrower roles Write.
  • Custom folders whose permissions you had already configured — those kept your settings.

To change any of this, edit the folder's permissions and add or remove Write for the Borrower, Co-Borrower and Non-Borrower roles.

Default permissions

Every System Default folder gives Write / All to Admin, Loan Officer, Loan Processor, Loan Officer Assistant and Supporting Loan Officer. Some add more:

Folder Additional default access
Borrower Portal Document Vault Borrower, Co-Borrower, Non-Borrower: Write / Own
Partner Portal Document Vault Buyer Agent, Seller Agent: Write / Own
Settlement Agent Vault Settlement Agent, Title Insurance Agent, Escrow Agent: Write / Own
POS Documents - PreApprovals and PreQualifications Borrower, Co-Borrower, Non-Borrower: Read / All. Buyer Agent, Seller Agent, Settlement Agent, Title Insurance Agent, Escrow Agent: Read / Own
EConsent, POS Documents - Credit Authorization Borrower, Co-Borrower, Non-Borrower: Read / Own
POS Documents - TCPA Buyer Agent, Seller Agent: Read / Own
Loan Comparisons, Electronic Verification of Assets / Employment / Income, Credit Report, Underwriting, Other Services, Verifications, SmartFees Transaction Details Staff only — no borrower or partner access

Custom folders created for you from your existing buckets received Borrower, Co-Borrower and Non-Borrower Write / Own; Admin and the four staff roles Write / All; and no access for Buyer, Seller, Settlement, Title Insurance and Escrow Agents. The same defaults apply when an administrator types a new folder name on a task or document template. Folders you had already configured were left alone.

Folders you create yourself in Account Settings have no defaults. Only the permissions you add apply.

Related