This module adds a workflow to approve page modifications and show the approved version by default.
auto_awesome What this module does
AI-generated from the code · Odoo 19.0Adds an approval workflow to knowledge pages: edits become Change Requests that must be approved before they replace the published content. Approvers get notified by email and can approve, cancel or reopen requests.
This module turns page edits into a controlled approval process. When a page (or one of its parent categories) is marked as requiring approval, saving a change no longer updates the visible page directly: it creates a Change Request instead, and the page keeps showing the last approved version.
On a page you will see warning banners when approval is required, when changes are waiting for approval, or when you already have a draft request for that page. A "Change Requests" button in the page's button box opens the related requests.
Each Change Request has a status: Draft, Pending Approval, Approved or Cancelled. From the request form you can use the buttons Send to Review, Approve, Cancel and Back to draft, depending on your rights. Content, title and summary are only editable while the request is in Draft; document managers can still edit the title and summary afterwards.
When a request is sent for review, the approver groups of the page are subscribed and an email is sent with the page link, the author, the date, the summary and a diff against the previous approved version. Approving records who approved and when, posts messages on the request and on the page, and makes the new version the current one.
A "Change Requests" menu is added under the Knowledge menu, with filters by status and grouping by state or approver. Access is controlled by a new Approver group and record rules.
Depends on
Menus it adds
Models and fields (2)
- document.page · extends an existing modelhistory_ids, approved_uid, approver_gid, am_i_approver, approved_date (Approved Date), user_has_drafts (User has drafts?), approval_required (Require approval), approver_group_ids (Approver groups), is_approval_required (Approval required), has_changes_pending_approval (Has changes pending approval)
- document.page.history · new modelstate, page_url (URL), am_i_owner, approved_uid, am_i_approver, approved_date, is_approval_required (Approval required)
Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 8 confirmed, 1 with no information of 9 versions.
Sources · Odoo 15.0
Confirmed on 2026-11-03 in branch 15.0 of OCA/knowledge.
terminal Installation and usage
OCA documentation · Odoo 19.0Configuration
Source · Odoo 19.0To configure this module, you need to:
- Set a valid email address on the company settings.
- Go to Knowledge \> Categories.
- Create a new page category and set an approver group. Make sure users belonging to that group have valid email addresses.
Usage
Source · Odoo 19.0To use this module, you need to:
- Go to Knowledge \> Pages
- Create a new page and choose the previously created category.
- A notification is sent to the approvers group with a link to the page history to review.
- Depending on the review, the page history is approved or not.
- Users reading the page see the last approved version.
No verified information in OCA: Installation.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.