Overview
Approval for current page version management allows admins to mange approval processes for different versions of confluence pages. In order to set up, you will follow steps as below.
Global Settings
Navigate to Apps → Settings → General, and you will find Approval for current page version section.
Current page version approval
This is the starting point for configuring how approvals will work for new pages or existing ones that have been updated. You can select the option that best fits your needs.
Enabled: “Approve the current version of the page” value will be unchecked for each new definition.
Set as default: Value will be checked for each new definition.
Required: Value will be mandatory for all definitions.
Disabled: Value will be completely turned off and can’t be enabled for any definition or page.
The next option is managing automatic re-approvals when a page is edited and a new version is created.
In the settings, you can specify which Approval Statuses (such as "Approved", "Rejected", or "In Progress") will automatically trigger a re-approval when a change is made to the page.
These global settings like selecting statuses or setting automatic interval reminders can later be overridden at pages or definitions levels.
Definition-level settings
Navigate to Apps → Definitions.
You can enable/disable settings at the definition level.
If you allow Approve the current version of the page,
"Approve the current version of the page" checkbox is available at the definition level.
This allows you to decide if the current version of the page should be subject to approval based on how the page is defined.
Approval statuses causing automatic re-approval after a change on the page - show statuses marked at higher level, can be unchecked
Page-level settings
‘Approve the current version of the page’ can be later changed on page view 'New' tab when parametrize option is clicked.
Option can be changed only if Current page version approval is not set as Required or Disabled
Approval statuses causing automatic re-approval after a change on the page - show statuses marked at higher level, can be unchecked
Outdated Approvals
If the page version is changed, all approvals associated with the given version will be added to the approval_path_outdated (approval_id, changed_by, change_date) table.
if the approval status is on the list of automatically renewed run approval based on the current version of the definition, notify person who started approval about automatic renewal
if not, person who started approval will be informed by receiving a direct email message with a link allowing them to open the approval on the confluence page.
Outdated approvals should have the option to be manually restarted (based on the current version of the definition - this should be communicated to the user in a tooltip over the action icon).
In addition:
In the approval list view, we will display an additional status of OUTDATED for all such approvals.
The actions approve/reject/send notification will not be available.
The same should be added to the approval list for the per space and global views.
For external users, we should not display information about approvals with such a status.
On the Approvals tab, the option to filter by page version should be added.
Outdated status should be added to the filter parameters.
Default status should be something like 'Unarchived and up-to-date' (means not archived and not outdated)