PLT-16Core CrmLeafAdministratorUser

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.

Part 1 · Platform Setup and Administration10 min readIncludes a Service / PSA lens

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

AcceptedLimit
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

AspectFile ManagerRecord attachment
What it holdsShared documents that do not belong to one recordFiles belonging to a specific lead, project, task, invoice, purchase order, survey or other record
StructureA nested folder treeAttached directly to the record
ScopePer Company and OrganizationFollows the record and its own visibility
Typical usePolicies, templates and reference material as spreadsheets, Word documents or PDFsSurvey photographs, receipts, delivery proof, signed documents, and any file type the File Manager does not accept
File typesSpreadsheets (.xls/.xlsx), Word (.doc/.docx), PDF only, up to 20 MB — plus spreadsheets created and edited onlineNo 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 / PSA lens

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

IssuePossible CauseResolution
A folder you created is not visibleYou are in a different OrganizationSwitch to the Organization where the folder was created.
An upload is rejectedThe file is not an Excel, Word or PDF file, or it is over 20 MBConvert 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 deleteIt still contains files or subfoldersDelete the contents first, then delete the folder.
A file attached to a record is not in the File ManagerRecord attachments are separate from the folder treeOpen the record to reach the file. This is expected behaviour.
A user cannot open the File ManagerThe Employees module is not enabled for the accountAsk your Administrator to enable the Employees module.
A downloaded file will not openThe file was incompletely uploadedUpload 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.

Still need a hand?

Our support team answers on business days. Reference PLT-16 so we can jump straight in.