--- title: "Applying an approval workflow to an Individual Page" canonical: "https://support.appfire.com/space/CDACL/630953368/Applying%20an%20approval%20workflow%20to%20an%20Individual%20Page" format: markdown --- > Macro (aura-html) ## Overview A user with **edit** permissions in a space can add and apply the Comala Document Approval app approval workflow on a page-by-page basis to a page or blog post. ## Add and Apply the Approval > Macro (excerpt) > > On a page, choose **Page Tools** and **Add Page Approval.** > > ![image](media://64c7b3e1-cf99-4284-8d21-4dfc58cb26b2) > > A screen notification confirms that the Comala Document Approval app workflow is successfully applied to the content and that you may need to refresh your browser. > > ![image](media://e99c6d8e-66a5-42f5-8815-6ecd3ad9f258) > > The [approval content byline item](https://appfire.atlassian.net/wiki/spaces/CDACL/pages/612893589) is added as a breadcrumb to the page subtitle. > > ![image](media://f4a97879-3f91-4f9e-8f36-3ff993ba9733) > > The content is in the default initial workflow state: the **Review** state.  > > The content in the **Review** state is now considered as draft content and only users with **edit** or **admin** permission for the content will be able to view the page or blog post. ## Approval Workflow States Adding Comala Document Approval applies a basic [approval workflow](https://appfire.atlassian.net/wiki/spaces/CDACL/pages/612892820) to the content. The workflow consists of three states: ![image](media://c9eca07f-a712-45a6-aeee-8bba7e1ad051) There are different [transitions](https://appfire.atlassian.net/wiki/spaces/CDACL/pages/612893317) that can occur between each of the three states depending on the activity The **Review** state has a content review (approval) that requires one or more users to **approve** or **reject** the content. - the applied workflow transitions to the appropriate destination state when the reviewer(s) agree on the approval decision. There is also an approval when the content is in the **Rejected** state. Each content review has a different destination for the **approve** decision. The content review in the **Rejected** state only has the **Approve **button as a choice. An automatic transition to a new state occurs when the page is edited and updated in the following states - **Approved** - **Rejected** ## Approve the content > Macro (excerpt) > > By default, any user with **Edit** permissions can undertake the [content review](https://appfire.atlassian.net/wiki/spaces/CDACL/pages/612893115) (*the approval*) to **Approve** or **Reject** the page or blog post. This is done through the approval pop-up: > > ![image](media://6218106e-8d81-4e92-89ec-f0ec7141623e) > > The content review (*approval*) is characterised by two buttons "**Approve**" and "**Reject**". > > Approving or rejecting the content will cause the page or blog post to transition (move) to another state in the workflow. The reviewer has the option choose **Add** **comment**. The comment will be included with any notification of the approval sent to a user. Approvals and the comments are also recorded in the workflow history report. > > In the **Review** state above: > > - an **Approve** decision will publish the content to the **Approved** state > - a **Reject** decision will move the content to another draft state, the **Rejected** state Content in the **Rejected** state is also subject to a content review: ![image](media://f24bf142-4c25-4476-8c71-044517a9a615) In the **Rejected** state: - an **Approve** decision will publish the content to the **Approved** state - there is no option to reject the content within this content review. But if the page or blog post is edited and saved in this state, the workflow will automatically transition to the **Review** state Approved content The **Approved** state is the version of the page or blog post that is considered the final version of your content. ![image](media://c350a4b7-aadd-4689-8f3d-3a90d30b7c45) Users will be able to view the workflow activity history for the content by choosing the **Activity Report** button in the workflow popup. Any changes to the content will transition the content back to the **Review** state. Page editors and admin users will be able to view the draft content in the **Review** state. An additional breadcrumb is added to the page for editors to view the current approved content. ![image](media://94a1db2b-4d0a-4914-934d-cf37a4c3165b) ## Assign a reviewer One or more [users can be assigned](https://appfire.atlassian.net/wiki/spaces/CDACL/pages/612893108) to undertake a content review. - choose **+Add Reviewer** ![image](media://537887c8-9788-488d-9318-74c9d177952e) - type in the search option to find a user to assign as a reviewer - check the box for the chosen user - choose Assign to add the user as a reviewer for the approval ![image](media://b7e30cfb-f310-4a57-94d4-13a3183b5174) > ℹ️ Once a reviewer is selected you can choose **Add note** before you [assign the user](https://appfire.atlassian.net/wiki/spaces/CDACL/pages/612893108) to send a note with the notification of the content review assignment. The avatar fo the assigned reviewer is displayed in the workflow popup. ![image](media://bb6e14c8-313b-42d7-906e-fdd369cd8b55) Once one or more reviewers are assigned to the content review - only the assigned reviewer(s) can undertake the content review - both the **approve** and **reject** buttons are disabled > 📝 Any reviewer who has not yet undertaken an approval decision can be unassigned as a reviewer. Other users can also be assigned as a reviewer. [Additional reviewers can be assigned](https://appfire.atlassian.net/wiki/spaces/CDACL/pages/612893609) but if more than one reviewer is assigned, all the reviewers must agree on the approval decision for the workflow to transition. ### Multiple reviewers Each content review can have more than one assignee. To add reviewers - choose **+Add Reviewers** - search for a user - check the box next to the user to be assigned - repeat a search and check the box for another user - choose **Assign** ![image](media://3c346c57-d100-4bac-8492-74ebc76c35df) The avatar for each assignee will be added to the approval popup. ![image](media://f166624d-2e5c-4b2b-be6a-1fa4f4b6dc58) The approve and reject buttons are disabled for all other users including those with **admin** permissions. Additional reviewers can be assigned (or existing reviewers unassigned) until all the reviewers agree and the approval transition occurs. - each of the assignees can either approve or reject the content - each assignee's decision is shown in the approval popup ![image](media://a55b69da-6cbe-461d-9db4-bca35caa7db0) An assignee can change their decision if the other assignee for the approval has not yet undertaken the review, or has made a different decision: ![image](media://bc1e5bfa-9f9f-4fcc-8afb-9c20896c0a59) > ℹ️ All assignees must agree to approve (or reject) the content for any transition. All individual review decisions are recorded in the **[Approval Document Activity Report](https://appfire.atlassian.net/wiki/spaces/CDACL/pages/612892827)** report. ## Removing a page approval Choose [Remove Page Approval](https://appfire.atlassian.net/wiki/spaces/CDACL/pages/612893630) from the page tools menu. > 📝 If the current user removing the page approval has admin permission for the space, the [approval document activity history](https://appfire.atlassian.net/wiki/spaces/CDACL/pages/612892827) can be retained. > Macro (excerpt-include)