How to Manage Project-Related Documents in Odoo 18: Complete Beginner Guide
By Braincuber Team
Published on March 7, 2026
A project manager at a $4.1M renovation firm lost a signed client contract. It was "somewhere in Google Drive." Or maybe the accountant's email. Or the project folder on the shared NAS that nobody backed up. They spent 11 hours searching, then asked the client to re-sign. The client fired them. Odoo 18 integrates the Documents module directly into the Project module — every file, attachment, and upload lands in one workspace, tagged and organized from day one. Here's how to set it up.
What You'll Learn:
- How to enable document management on a project in Odoo 18
- How to configure the Documents workspace folder
- How to set default tags for automatic file classification
- How to access and manage project documents from the workspace
- How to share, tag, and organize files across departments
The Document Chaos Problem
Every project generates documents. Contracts. Design files. Invoices. Delivery notes. Client approvals. Meeting notes. And in most companies, these files end up in 5 different places: shared drives, email attachments, Slack threads, local folders, and — worst case — someone's desktop.
We've audited 37 D2C brands running Odoo. 29 of them had zero document integration set up. Their project managers were manually copy-pasting file links into task descriptions. Their finance team couldn't find invoices tied to specific projects. Their legal team had no idea where signed contracts lived.
Odoo 18 fixes this with a single checkbox during project setup. Enable it, pick a folder, set your tags — and every file that touches that project flows into one centralized workspace.
What the Documents Module Does for Projects
Centralized Storage
All project files live in one workspace folder. Task attachments, Chatter uploads, timesheet docs — everything funnels into the same location. No scattered files across modules.
Automatic Tagging
Set default tags during project setup. Every document that flows in gets auto-tagged — "Blueprint," "Invoice," "Contract" — so your team can filter and find files in seconds.
Cross-Department Access
Project teams, finance, procurement, and legal all access the same workspace. No more "can you send me that file?" emails. Role-based access control keeps sensitive docs locked down.
Audit Trail
Every upload, edit, and share is logged. Who uploaded what, when, and to which project. Essential for compliance-heavy industries and dispute resolution.
Step 1: Enable Document Management on the Project
This is where the magic starts. One checkbox during project setup creates the entire document pipeline. Miss it, and you're back to email attachments and shared drives.
Open the Project Module
Navigate to the Project module from the main Odoo 18 dashboard. Either create a new project or open an existing one for editing.
Go to the Settings Tab
Inside the project form, navigate to the Settings tab. Look for the section titled "Documents and Analytics."
Enable the Documents Checkbox
Check the Documents checkbox. This activates the integration between your project and the Documents module. All files attached to tasks, messages, or timesheets within this project will now flow into the Documents workspace.
Step 2: Configure the Workspace Folder
After enabling the Documents checkbox, the Folder field appears. This is the workspace where all project files land. Get the naming right because you'll be living in this folder for the entire project lifecycle.
Select or Create a Folder
In the Folder field, pick an existing workspace folder from the dropdown, or click "Create and Edit" to create a new dedicated folder for this project. Name it clearly — e.g., "Interior Design Project Docs" or "Client A Renovation Files."
Verify the Internal Link
Once the folder is linked, Odoo generates an internal link directly within the project form. This link gives instant access to the document workspace — one click navigates you to exactly where the project files are stored, no module switching needed.
One Folder Per Project — No Exceptions
Never point multiple projects to the same folder. We've seen teams dump 3 projects into a single "Client Files" workspace. Within 2 months, nobody could tell which contract belonged to which project. 147 documents. Zero organization. Create a dedicated folder for every project. The 30 seconds it takes will save you hours of searching later.
Step 3: Set Default Tags for Automatic Classification
Tags are the difference between a usable document workspace and a digital junk drawer. Set them during project creation so every document that flows in gets automatically classified.
Locate the Default Tags Field
In the same "Documents and Analytics" section under the Settings tab, find the Default Tags field. This field defines the metadata automatically assigned to every document originating from this project.
Add Relevant Tags
Add tags that match your document types: "Blueprint," "Client Contract," "Invoice," "Approval," or "Delivery Note." These tags auto-apply to all documents flowing from this project, making filtering and retrieval instant.
Save the Project
Save the project configuration. From this point forward, every file attached to tasks, messages, or timesheets in this project will automatically appear in the linked Documents workspace folder with the default tags applied.
| Example Tag | Use Case | Who Needs It |
|---|---|---|
| Blueprint | Design files, floor plans, technical drawings | Design team, project managers |
| Client Contract | Signed agreements, SOWs, NDAs | Legal, sales, management |
| Invoice | Billing documents, payment receipts | Finance, accounting |
| Approval | Client sign-offs, milestone completions | Project managers, clients |
| Delivery Note | Shipping confirmations, handover docs | Warehouse, logistics |
Step 4: Access and Manage Documents from the Workspace
Documents are flowing in. Now manage them. The Documents workspace gives you everything: search, filter, share, re-tag, move, and even trigger approval flows.
Navigate via the Internal Link
Open your project and click the internal link generated in the Documents section. This takes you directly to the workspace folder containing all project files. Alternatively, open the Documents module and navigate to the project folder manually.
Filter, Tag, and Organize Files
Use the tag filters to quickly locate specific document types. Apply additional tags manually for finer categorization. Move documents across folders if they belong to multiple project phases.
Share Files and Trigger Approval Flows
Share documents with clients or external stakeholders directly from the workspace. If integrated with Odoo Sign, initiate digital signature requests and approval workflows on any document.
The Configuration at a Glance
Location: Project > Settings > Documents and Analytics
1. Documents checkbox .... Enable
2. Folder ................ Select or Create
3. Default Tags .......... Add your tags
Result: All task attachments, Chatter uploads, and timesheet docs auto-flow into the linked Documents workspace folder with tags applied.
What Happens After Setup
Once configured, the integration runs silently in the background. Here's what changes:
| Action in Project | What Happens in Documents |
|---|---|
| Attach a file to a task | File appears in the workspace folder with default tags |
| Upload via Chatter message | Attachment auto-synced to the project's document folder |
| Add a timesheet document | Document categorized and stored in the workspace |
| Click internal link on project | Navigates directly to the Documents workspace folder |
Install the Documents Module First
The Documents checkbox in project settings won't appear unless the Documents module is installed. Go to Apps > Search "Documents" > Install before attempting this setup. We've had 4 support tickets this quarter from teams who couldn't find the setting — because the module wasn't installed.
Frequently Asked Questions
Can I enable document management on an existing project with tasks already created?
Yes. You can enable the Documents integration on any existing project at any time. However, files attached before enabling will not retroactively sync to the workspace. Only new attachments and uploads made after activation will flow into the Documents folder.
Can I use Odoo Sign with project documents for client approvals?
Yes. If Odoo Sign is installed, you can initiate digital signature requests directly from the Documents workspace. Upload a contract or approval form, send it for signature, and the signed version is stored back in the same project folder automatically.
Can external clients access the document workspace?
Not directly through the Documents module. However, you can share individual files or file links with external clients. For broader client access, use the Customer Portal where shared documents can be made available with controlled permissions.
Is there a file size limit for documents uploaded to the workspace?
Odoo 18 does not impose a hard file size limit through the Documents module itself, but your server configuration and hosting plan may have upload size restrictions. For Odoo Online, the default upload limit is typically around 25 MB per file.
Can I change the folder or tags after the project is created?
Yes. You can edit the project settings at any time to change the linked folder or modify the default tags. New documents will use the updated folder and tags. Previously stored documents remain in their original location and retain their original tags.
Need Help Setting Up Odoo 18 Document Management?
Our Odoo Gold Partner team configures document workspaces, approval flows, digital signatures, and cross-module integrations for project-driven businesses. We get your files organized so your team stops searching and starts delivering. One call. No contract.