Skip to content

Odoo Documents Module: Complete Management Guide

DeployMonkey Team · March 23, 2026 11 min read

What Is Odoo Documents?

Odoo Documents is a centralized document management system (DMS) that replaces scattered file storage with organized, searchable, and automated document handling. It integrates deeply with Accounting, HR, and other Odoo apps so that invoices, contracts, expense receipts, and employee documents all live in one place.

Installation and Activation

Install the Documents module from Apps. Once activated, you will see a new Documents menu in the top bar. The module creates a default workspace structure that you can customize.

Key Configuration Settings

  • Centralize Bills — Automatically routes vendor bills from Accounting to Documents
  • HR Documents — Employee contracts, payslips, and appraisals stored centrally
  • Sign Integration — Send documents for electronic signature directly

Workspaces

Workspaces are the primary organizational unit, similar to folders but more powerful.

Setting Up Workspaces

  1. Go to Documents → Configuration → Workspaces
  2. Create a workspace hierarchy (e.g., Finance → Invoices, Finance → Contracts)
  3. Set access rights per workspace — who can read, write, or manage
  4. Assign tags specific to each workspace
# Recommended workspace structure:
# Finance/
#   ├── Vendor Bills
#   ├── Customer Invoices
#   ├── Bank Statements
#   └── Contracts
# HR/
#   ├── Employee Files
#   ├── Recruitment
#   └── Payroll
# Projects/
#   ├── Client A
#   └── Client B

Tags and Categorization

Tags provide flexible categorization beyond the workspace hierarchy. Each workspace can have its own tag categories (called tag facets).

Tag FacetTagsUse Case
StatusDraft, Approved, ArchivedTrack document lifecycle
PriorityUrgent, Normal, LowFlag important documents
DepartmentSales, Finance, HRCross-workspace filtering
Year2024, 2025, 2026Fiscal year organization

Upload and Processing

Uploading Documents

Documents can be uploaded by drag-and-drop, email alias, or API. Each workspace can have an email alias — any email sent to that address creates a document automatically.

Automated Actions (Workflow Rules)

Workflow rules automate document processing. Go to Documents → Configuration → Workflow Actions.

  • Create a vendor bill — Upload a PDF invoice, click the action, and Odoo creates a bill with OCR-extracted data
  • Create a task — Turn a document into a project task
  • Request signature — Send for e-signature via Odoo Sign
  • Move to workspace — Automatically file documents based on tags
  • Set tags — Auto-tag based on content or source
# Example: Auto-process vendor bills
# 1. Upload PDF to "Vendor Bills" workspace
# 2. Odoo OCR extracts vendor, amount, date
# 3. Click "Create Bill" action
# 4. Draft bill created in Accounting
# 5. Document linked to the bill record

Sharing and Access Control

Share Links

Share documents or entire workspaces externally without giving Odoo access:

  1. Select documents → Share
  2. Set expiration date and access level (view or download)
  3. Generate link or send directly via email
  4. Track who accessed the shared documents

Access Rights

Documents uses a three-level permission model per workspace:

  • Reader — View and download only
  • Editor — Upload, edit tags, request actions
  • Manager — Full control including delete and configuration

Integration with Other Modules

Accounting Integration

Enable document centralization in Settings. Vendor bills and customer invoices are automatically stored in Documents. You can upload a bill PDF and convert it to an accounting entry with one click using AI-powered OCR.

HR Integration

Employee documents like contracts, ID copies, and certifications are stored in the HR workspace. Employees can upload documents from their self-service portal. Managers can request document submissions with deadlines.

Sign Integration

Send any document for electronic signature. Track signature status. Completed signed documents are automatically filed back into the workspace.

Spreadsheet and Preview

Odoo Documents includes a built-in document viewer for PDFs, images, and videos. The Spreadsheet integration lets you create and edit spreadsheets directly within the Documents interface, with the ability to pull live data from Odoo.

Best Practices

  • Define workspace structure early — Plan your hierarchy before uploading thousands of files
  • Use email aliases — Let vendors and partners send documents directly to the right workspace
  • Set up workflow actions — Automate repetitive filing and processing tasks
  • Regular cleanup — Archive old documents to keep workspaces navigable
  • Access control — Apply the principle of least privilege per workspace

DeployMonkey + Documents

DeployMonkey provisions Odoo instances with the Documents module pre-configured. Our AI agent helps design your workspace structure, set up workflow actions, and configure email aliases based on your business requirements.