Starting with Odoo 18, the Project app introduces version history for task descriptions.
This means that every change to a task’s description is tracked, along with the user who made the change. You can review past versions, compare changes, and even restore an earlier version if needed. When a description is restored, Odoo automatically creates a new revision, keeping the full history intact.
Accessing Version History
In the task form view, open the Actions menu and select Version History.
If there are recorded changes, a popup window called Task Description History will appear.
- On the left panel, you’ll see all revisions, sorted by date (newest first).
- Selecting a revision shows the description’s value at that time.
Comparing Versions
The View Comparison button highlights the differences between two revisions with two available views:
Unified View (default):
- The entire current value of a line is shown in green.
- The entire previous value of a line is shown in red with strikethrough
- This view displays only visible text changes
Split View (available in Developer Mode):
- Additions and removals within the same line are highlighted with different shades of green/red, so the exact changes are visible.
- Shows a line-by-line comparison along with the full HTML structure, useful for technical review.
Restoring a Version
At the bottom of the popup, two actions are available:
-
Restore History: Opens a confirmation dialog. After confirmation, the selected revision is restored. -
Discard: Closes the window without changes.
Note: Only the last 300 revisions are visible (limit at the time of writing).
Permissions
This feature is available to all internal users who have access to the task.
Summary
The Task Description Version History makes it easy to track changes, review past revisions, and restore previous content. With both Unified and Split View comparison modes, users can quickly understand what changed at a glance or dive into detailed line-by-line edits. This feature helps teams maintain accurate task documentation, avoid errors and ensures full transparency for all updates.