How to Use the File Manager in CrmLeaf
All editions. Core feature — no add-on required. Attaching files held in Google Drive or OneDrive requires the Drive Integration add-on module.
Availability: All editions. Core feature — no add-on required. Attaching files held in Google Drive or OneDrive requires the Drive Integration add-on module.
Overview
The File Manager is a nested folder tree for the documents your team needs to keep in one place but which do not belong to a single record. It is scoped per Company and per Organization, and it is separate from the attachments that live on individual records.
It is built specifically for office documents, not for general file storage: uploads are restricted to spreadsheets, Word documents and PDFs (see Uploaded File Types, below), and it also has a built-in spreadsheet editor for creating and editing a spreadsheet directly online.
Use it for shared material such as policies, templates and reference documents in one of the supported formats. Use record attachments for anything that belongs to one lead, project, task, invoice or purchase order, and for file types the File Manager does not accept, such as photographs.
How It Works
You build a folder tree and upload files into it, or create a new spreadsheet directly inside a folder and edit it with the built-in spreadsheet editor. The tree belongs to the Company and to the Organization you have selected, so each workspace has its own structure. Files are written to whichever storage destination the account has configured.
Create folders → Upload files or create a spreadsheet → Organise into the tree → Team members open files → Download when needed
- Folders can be nested, so you can build a structure that matches how your business thinks about its documents.
- The tree is scoped per Company and Organization. Switching Organization shows that workspace's own folders.
- Uploads are restricted to specific file types and a size limit — see Uploaded File Types, below. It is not a general-purpose file store.
- A spreadsheet can be created and edited online, without leaving the File Manager, using its built-in spreadsheet editor.
- It is separate from per-entity attachments. A file attached to a project, task, invoice or survey stays with that record and does not appear in the File Manager tree.
- Files are written to the account's storage destination — local storage, Amazon S3, DigitalOcean Spaces, Wasabi or MinIO — and they count towards the plan's storage limit.
- Access is controlled by the Employees module, not by a folder-specific permission. Anyone with that module enabled sees the whole tree for the Company and Organization they are in; no way to restrict visibility to particular folders was found.
Who Can Use This Feature?
Administrator
- Design the folder structure so people can find documents without asking.
- Confirm the storage destination is configured before the team uploads in volume.
- Watch usage against the plan's storage limit.
User
- Create folders and upload files within the workspace you are in.
- Create and edit a spreadsheet directly in the File Manager.
- Find and Download the documents you need.
- Rename or delete a folder or file you have access to; an empty folder deletes directly, but one with files or subfolders must be emptied first.
- Keep record-specific files on the record instead of in the shared tree.
Access requires the Employees module to be enabled for your account; every user with that module sees the full folder tree for the Company and Organization they are in.
Uploaded File Types
| Accepted | Limit |
|---|---|
Excel spreadsheets (.xls, .xlsx), Word documents (.doc,
.docx), PDF (.pdf) | 20 MB per file |
Other file types, including images, are not accepted by the upload control. If your team needs to store a photograph or another unsupported file type centrally, attach it to the relevant record instead, or ask about the Drive Integration add-on module.
Prerequisites
- File storage is configured for the account.
- You are in the Company and Organization whose folder tree you want to use.
- Storage headroom remains under the plan's limit.
- The Employees module is enabled for your account.
File Manager Compared with Record Attachments
| Aspect | File Manager | Record attachment |
|---|---|---|
| What it holds | Shared documents that do not belong to one record | Files belonging to a specific lead, project, task, invoice, purchase order, survey or other record |
| Structure | A nested folder tree | Attached directly to the record |
| Scope | Per Company and Organization | Follows the record and its own visibility |
| Typical use | Policies, templates and reference material as spreadsheets, Word documents or PDFs | Survey photographs, receipts, delivery proof, signed documents, and any file type the File Manager does not accept |
| File types | Spreadsheets (.xls/.xlsx), Word (.doc/.docx), PDF only, up to 20 MB — plus spreadsheets created and edited online | No file-type restriction found |
For Administrators
Step 1: Confirm storage is configured
What to do: Confirm the account's storage destination is set and working before the team starts uploading.
What to verify: A test upload succeeds and downloads intact.
Step 2: Design the folder structure
What to do: Agree a small number of top-level folders that reflect how your business looks for documents, and create them before inviting users to upload. A structure agreed once is far easier than a reorganisation later.
What to verify: Someone who did not design the structure can find a document in it.
Step 3: Repeat per Organization if needed
What to do: Because the tree is scoped per Organization, create the structure in each workspace that needs one. Keep the naming consistent across workspaces.
What to verify: Switching Organization shows that workspace's own folders with the expected names.
Step 4: Brief users on what belongs where
What to do: Tell users to attach record-specific files to the record and to use the File Manager only for shared material. This is the single decision that keeps both usable.
What to verify: Spot-check the tree after a few weeks. It should not be filling up with files that belong on records.
For Users
Step 1: Open the File Manager
What to do: Open the File Manager for the workspace you are in from the app switcher's Files tile. Check the active Company and Organization first, because each workspace has its own tree. (On the Payroll edition, the same screen is also reachable from the sidebar as All Files.)
What to verify: The folder tree you expect is shown.
Step 2: Create a folder
What to do: Add a folder, inside an existing folder if you need a nested structure, and give it a name your colleagues will understand.
What to verify: The folder appears in the tree in the right place.
Step 3: Upload files, or create a spreadsheet
What to do: Open the folder and Upload a file — Excel (.xls,
.xlsx), Word (.doc, .docx) or PDF, up to 20 MB. Other file types are
rejected. Alternatively, use Create Spreadsheet to start a new spreadsheet inside the folder and
edit it with the built-in online editor, without uploading anything.
What to verify: Each file (or new spreadsheet) is listed in the folder and can be opened.
Step 4: Find and download a document
What to do: Browse the tree, or use Search, then Download the file you need.
What to verify: The downloaded file opens correctly.
Step 5: Rename or remove an item
What to do: Rename a folder or file from the tree. To remove one, use Delete — a file deletes immediately, but a folder only deletes once it is empty; if it still holds files or subfolders, delete those first.
What to verify: The rename or deletion is reflected in the tree immediately.
Step 6: Keep record files on the record
What to do: Attach anything that belongs to a single lead, project, task, invoice, purchase order or survey to that record rather than to the File Manager, so the file travels with the work. Anything that is not a spreadsheet, Word document or PDF — a photograph, for example — has to go on the record anyway, since the File Manager will not accept it.
What to verify: The file is visible on the record to everyone who can see the record.
Expected Result
Your workspace has a nested folder tree containing the office documents and spreadsheets your team shares, files upload and download successfully, and record-specific files (and any file types the File Manager does not accept) remain attached to their records.
Service Organisation Context
The File Manager holds the engagement documentation a firm needs in one place but which does not belong to a single record — delivery methodology, document templates, rate cards, insurance certificates, accreditations and reference material. Because the tree is scoped per Company and Organization, a firm with several practices or offices keeps each workspace's shared material separate. Keep anything belonging to one engagement on the record itself: files attached to a project, task, invoice or contract stay with that record and never appear in the tree. The same separation between shared and record-specific documents serves any business.
Important Notes
- Menu names and their position can differ between product editions and can be customised for your account, so your sidebar may not match these paths exactly. Use Search or your Quick Access items if you cannot find a screen.
- The folder tree is scoped per Company and Organization. If a folder is missing, check which workspace you are in before assuming it was deleted.
- The File Manager only accepts Excel, Word and PDF files, up to 20 MB each. There is no way to upload an image or other file type here — use a record attachment instead.
- A folder can only be deleted once it is empty. Delete or move out its files and subfolders first.
- No option to move a file or folder to a different parent folder was found — recreate the structure with a new folder if you need to reorganise, or delete and re-upload.
- Anyone with the Employees module enabled can see every folder in the tree for the Company and Organization they are in. There is no way to restrict a folder to specific roles or users.
- The File Manager is separate from per-entity attachments. A file attached to a record does not appear in the tree, and a file in the tree is not attached to any record.
- Files count towards the plan's storage limit, wherever they are stored.
- Confirm the account's storage destination is configured before a large upload effort.
- Google Drive and OneDrive attachments come from the Drive Integration add-on module and are not part of the File Manager tree.
Common Scenarios
Example: shared templates and policies. An HR team keeps its policy documents and letter templates in a folder structure in the File Manager, so every employee can find the current version without asking.
Example: two branches, two trees. A contractor runs a north and a south branch as two Organizations. Each branch has its own folder tree with the same top-level names, so staff moving between branches recognise the structure.
Example: keeping survey photographs with the work. A surveyor attaches site photographs to the survey record rather than the File Manager — photographs are not an accepted File Manager file type in any case — so the images stay with the survey through assessment, estimate and installation.
Example: a working budget spreadsheet. A finance lead uses Create Spreadsheet inside the File Manager to start a shared budget tracker and edits it online with colleagues, instead of uploading and re-uploading a file from their desktop each time it changes.
Troubleshooting
| Issue | Possible Cause | Resolution |
|---|---|---|
| A folder you created is not visible | You are in a different Organization | Switch to the Organization where the folder was created. |
| An upload is rejected | The file is not an Excel, Word or PDF file, or it is over 20 MB | Convert or resave the file as .xls/.xlsx, .doc/.docx or .pdf and keep it under 20 MB, or attach it to the relevant record instead. |
| A folder will not delete | It still contains files or subfolders | Delete the contents first, then delete the folder. |
| A file attached to a record is not in the File Manager | Record attachments are separate from the folder tree | Open the record to reach the file. This is expected behaviour. |
| A user cannot open the File Manager | The Employees module is not enabled for the account | Ask your Administrator to enable the Employees module. |
| A downloaded file will not open | The file was incompletely uploaded | Upload the file again and download it to confirm. |
Frequently Asked Questions
Is the File Manager the same as record attachments?
No. The File Manager is a nested folder tree scoped per Company and Organization, restricted to Excel, Word and PDF files. Record attachments belong to a specific record and have no such file-type restriction.
Does each Organization have its own folders?
Yes. The tree is scoped per Company and Organization.
Where are the files actually stored?
In the account's storage destination — local storage, Amazon S3, DigitalOcean Spaces, Wasabi or MinIO.
Can I upload a photo or other file type to the File Manager?
No. Only spreadsheets (.xls/.xlsx), Word documents (.doc/.docx) and PDFs are accepted, up to 20 MB each. Attach other file types to the relevant record instead.
Can I control who sees a folder?
No. Visibility is not per-folder — anyone with the Employees module enabled sees the entire tree for the Company and Organization they are in.
Can I move a file into a different folder?
No move option was found. You can rename a file or folder, and delete a file or an empty folder, but there is no way to relocate an item to a different parent folder.
Related Articles
Our support team answers on business days. Reference PLT-16 so we can jump straight in.