--- title: "Setting up loan document folders" slug: "101-setting-up-loan-document-folders" updated: 2026-11-17T18:31:06Z published: 2026-11-17T18:31:06Z canonical: "docs.thebigpos.com/101-setting-up-loan-document-folders" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.thebigpos.com/llms.txt > Use this file to discover all available pages before exploring further. # Setting up loan document folders **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](https://docs.thebigpos.com/docs/en/61-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 - [Choosing a folder when uploading documents](https://docs.thebigpos.com/docs/en/61-choosing-a-folder-when-uploading-documents) - [Who can see documents uploaded to a loan](https://docs.thebigpos.com/docs/en/87-who-can-see-documents-uploaded-to-a-loan) - [Where borrower uploads land in Encompass](https://docs.thebigpos.com/docs/en/78-where-borrower-uploads-land-in-encompass)