How to Sync Odoo Enterprise Documents Workspaces to the Cloud

If your team relies on Odoo's native Documents app with structured workspaces for Sales, HR, Finance, Contracts, or Projects you've probably run into a version of the same issue every growing team eventually hits: those workspaces get heavier every week, and there's no built-in way to offload them to external cloud storage without breaking the folder structure your team already depends on.

That's the specific gap Cloud Storage Integration Odoo Enterprise is built to close. This isn't a general-purpose attachment sync tool, it's a dedicated bridge module that extends cloud sync directly into Odoo's native Documents app, preserving your workspace structure while offloading the heavy lifting to the cloud.

Why Documents Workspaces Need Their Own Sync Approach

Odoo's Documents app is where structured business content lives in organized folders and sub-folders for Sales contracts, HR records, financial statements, project files, and more. That structure is exactly why generic attachment sync isn't enough here.

A basic sync tool might offload individual files, but it won't necessarily preserve the workspace hierarchy. Your team built the Sales/Contracts/2026 style folder trees that make Documents actually usable. Losing that structure during a cloud migration defeats the purpose.

This module was built specifically to solve that problem: syncing not just files, but the folder structure itself, so your cloud storage mirrors your Odoo Documents workspace exactly.

Key Features

Documents Workspace Sync

Files uploaded to native Odoo Document workspaces sync automatically to your connected cloud platform offloading heavy PDFs, media, and spreadsheets without manual intervention.

Two Sync Rule Modes

Choose between a Standard Record Rule (syncs attachments tied to individual database records into their own dynamic folders) or a Workspace-Related Rule (mirrors your actual Documents app folder tree Sales, HR, Finance, and their sub-folders directly onto your cloud storage). Most teams working within structured Documents workspaces will want the latter.

Kanban Sync Indicators

A cloud status icon appears directly on Document cards inside Odoo's native Documents Kanban view, so anyone browsing can tell at a glance whether a file has been safely synced.

Granular Workspace Rules

Define exactly which folders sync and which don't need to sync everything at once. Choose specific workspaces (Sales, Products, Contracts, Registrations, etc.) individually.

On-Demand + Automated Sync

A "Sync Workspaces Now" button lets you trigger structural sync manually and instantly. For hands-off operation, a background scheduled job also runs periodically to catch newly created workspaces or folders automatically.

Background FIFO Queue

File uploads are queued and processed asynchronously in the background, so large uploads don't freeze the interface or interrupt daily work. Failed transfers retry automatically through Odoo's scheduled actions.

Multi-Cloud Compatibility

Works with Google Drive, Microsoft OneDrive, SharePoint, Dropbox, Nextcloud, and Amazon S3 and supports multi-company, multi-client environments.

Reversal Sync Wizard

Need to bring files back? The reversal wizard restores cloud-synced attachments back into local Odoo binaries, with transaction safeguards in place.

What Actually Happens to Your Files

Here's the part worth understanding clearly before you install anything: once a file is uploaded and successfully synced to your cloud provider, the local binary is deleted from your Odoo database, and the attachment is converted into a link-type reference instead. This is what actually frees up server storage, it's not just a backup copy sitting in the cloud alongside a full local copy.

If a cloud connection is ever paused, sync activity stops and files stay safely local until you resume nothing is lost or left in a broken state.

Important Compatibility Notes (Read Before You Install)

This is genuinely important, so we're putting it up front rather than burying it in fine print:

• Requires Odoo Enterprise. Because this module integrates directly with the native Enterprise Documents app, it does not work with Odoo Community edition.
• Not compatible with Odoo Online (SaaS). Like most third-party modules requiring custom installation, this only works on Odoo.sh or on-premise deployments.
• Depends on a core module. This bridge extends the core Cloud Storage Integration module (which itself works with both Community and Enterprise) so it's built to work alongside that base sync engine, not replace it.

If you're on Odoo Online or Community edition, this specific module won't be installable; the core cloud storage integration module is the right starting point instead, and our Odoo Integration services team can help assess which setup fits your environment.

Is This the Right Module for Your Team?

This module makes the most sense if you're already using Odoo's native Documents app with real workspace structure (not just scattered attachments across records), you're on Odoo Enterprise running on Odoo.sh or on-premise, and you want your cloud storage to actually mirror that folder structure not just dump files into one flat location.

If any of those don't apply, say, you're on Odoo Online, or you don't use the Documents app specifically, the core Cloud Storage Integration module is likely the better starting point.

Frequently Asked Questions