In this SharePoint tutorial, learn what is SharePoint content approval? How to enable content approval in SharePoint 2013/2016/2019 or SharePoint Online. Then I will show, how to approve/reject list items or documents in SharePoint Online using the SharePoint list/library content approval feature.
What is SharePoint content approval?
SharePoint content approval feature allows approvers (members of a site who have approver permission) to publish list items or documents for a list or library.
If a SharePoint list or document library has a document approval feature enabled, then when a user adds an item or document to a document library, it will not available to all the users, the item will be in pending stage. Once an approver, approves an item or document then only it will be available to all the users.
By default, content approvals are turned off and any user with reading access can see draft items in most apps. SharePoint sites created with the publishing site template, already have content approval turned on in the Pages app.
Why SharePoint Content Approval is required?
SharePoint lists and libraries can often contain sensitive information which can be important to have only “official” versions of items or files viewable by users. And to view this you require the approval of an item or file before the content becomes visible to most site users.
By requiring approval, the organization can apply a significant level of quality and security to the content in the lists and libraries.by enabling this a document draft awaiting content approval is in the Pending status. When an approver reviews the document and approves the content, it becomes available for viewing by users who have read permissions.
A document library owner can enable content approval for a document library and, optionally, can associate a workflow with the library to run the approval process.
The best example to explain is if we are creating a blog site we need to review all blogs from the contributors before publishing.
Enable Content Approval in SharePoint List or Document Library
Here we will see first how we can enable/disable content approval in a SharePoint list or document library in SharePoint Online/2013/2016.
If you are using a modern SharePoint list or library, click on the gear icon and then click on List Settings/Library Settings like below:
Open the SharePoint list or document library and click on Library Settings like below, if you are using a classic SharePoint site.
Now click on Versioning Settings which is under General Settings in the list or library settings page.
There you can see Content Approval section, choose Yes for “Require content approval for submitted items?” like below:
Next, we come up with Document Version History where you find three options,
- No Versioning: If versioning is not being used and a new document is uploaded to the document library, it is added to the library in the Pending status and is not visible by users who have read permissions until it is approved.
- Create major versions: If major versioning is being used and a new document is uploaded to the document library, it is added to the library in the Pending status and is not viewable by users who have read permissions until it is approved as version 1.
- Create major and minor versions: If major and minor versioning is being used and a new document is uploaded to the document library, it can be added to the library either in the Draft status as version 0.1 or the author can immediately request approval. In this case, the document’s status becomes Pending.
Here we have select Create major version as we don’t want viewers to view who have read permissions until it is approved.
Draft Item Security Specify which users should be able to view drafts in this document library. Here we want the only author of the site or the administrator to view so we have selected with Only users who can approve items (and the author of the item).
Next comes up with require to Check Out where it asks us to Specify whether users must check out documents before making changes in this document library or not. Then click on the ok button to activate.
Now an item or a file in a site gets approved in a list or library if the person has Full Control or Design permissions. As an administrator, we will follow steps to approve items.
In modern SharePoint list or library, you can see two views got added like below:
In classic site, we can see a new column has been added as Approved Status as well as two new view types are created alongside with default view. These are Approve/reject Items and My Submissions view.
In the modern list, you can see the Approval Status column. By default, the Approval Status of each existing items will be Approved.
If you will open the Approve/reject Items list view in the SharePoint site. You will see all your Pending and Approved Items like below:
Clicking on Approve/reject items view we can see various status and items in it like how many files are in approved state and how many are in pending and how many are rejected.
My Submissions view helps to look into documents and items which are submitted by the logged in user.
Approve/Reject Items or Documents after Content Approval Enabled
Now, we will see how an approved can approve/reject items after content approval has been enabled in the SharePoint Online list or library.
There are two ways, we can Approve or Reject items.
Select the SharePoint Online list item and then click on the ... -> Approve/Reject from the command bar like below:
Or Select the ECB menu and then click on More -> Approve/Reject like below:
Then you can select from the below options:
And you can put additional comments also in the Comment box like below:
It will add one additional column as "Approver Comments" like below, where you can see the Approver's comment.
In the classic SharePoint list, Open the SharePoint list or document library and select an item. Click on [...] -> Advanced and then click on Approve/Reject.
Choose Approved option, to make the item visible to all users. Choose Rejected if you want to reject the item and it will return the item to the creator and the item will only be visible to the creator and all other users who can see the draft. If you choose the Pending option, then the document will be visible to the user who created the item as well as to all the users who can see draft items in SharePoint Online.
How to turn off content approval in SharePoint
How to turn off content approval in SharePoint? To turn off content approval in the SharePoint document library, Open the SharePoint Online document library -> Settings icon -> Library settings, then click on Versioning settings under General Settings.
Then in the Versioning Settings page, Set No to Require content approval for submitted items? like below:
This is how to turn off content approval in SharePoint document library or list.
SharePoint content approval permissions
By default, when someone submits an item or document, it will be in a pending status. Before someone approves it, it will be in the Pending status.
Let us see what permission is required for someone to approve or reject an item in SharePoint. In SharePoint modern list or library, a user requires, Manage Lists permission to approve or reject an item.
In classic SharePoint sites, a user requires approval permission to approve or reject items. Contribute permission should work fine. You can create a custom permission level, and enable Approve Items permission. Then create a custom SharePoint group, assign the custom permission level to the SharePoint group. Then add all your users to the particular group, make sure you should add only those users who you want they can approve.
This is all you need to know on SharePoint content approval permissions.
You may like following SharePoint tutorials:
- Disable document edit properties based on user permission in SharePoint document library
- Get SharePoint document library size using PowerShell
- Microsoft Flow Example: Copy new files from your PC to SharePoint Online Document Library
- Microsoft Flow Example: Product Notification Approval Flow
- Microsoft Flow: The execution of template action ‘Switch’ failed
- The ETag of this item does not match the one used for setting content approval status error in Microsoft Flow
- Microsoft Flow Example: When an item is created in SharePoint List, Send approval and create item
- Microsoft Flow Example: Email notification after approval from a SharePoint list
- SharePoint designer workflow: Create Laptop Request Approval Workflow
- Approval Workflow in SharePoint Online with example
Here I have explained what is content approval in SharePoint Online or SharePoint 2013/2016? Why we require content approval in SharePoint? And how to enable content approval in the SharePoint list or document libraries. Then also I have shown how an approver can approve and reject items in SharePoint Online or SharePoint 2013/2016/2019.
Hello Everyone!! I am Bhawana a SharePoint MVP and having about 10+ years of SharePoint experience as well as in .Net technologies. I have worked in all the versions of SharePoint from wss to Office 365. I have good exposure in Customization and Migration using Nintex, Metalogix tools. Now exploring more in SharePoint 2016 🙂 Hope here I can contribute and share my knowledge to the fullest. As I believe “There is no wealth like knowledge and no poverty like ignorance”
A great article! Very Informative! One question though: how/where do I see any comments that are included with the content approval/rejection?
Hi Bhawana, Such a great explanation and it is very useful for us. We are expecting more articles from you. Thaks for your effort.
Hello, I try to open Approve.aspx from PowerApps by clicking on custom button as launch(“https://mysptest.sharepoint.com/sites/AvianTest/_layouts/15/approve.aspx?List=%7B1e3329c5-f919-47f6-a21a-3b3c225cbf2d%7D&ID=23&&IsDlg=1”)
it is opening in separate tab instead of as modal dialog form as you mentioned in above image (SharePoint Content Approval Form).
How can I do this?
I want to copy the Approved/Rejected items to another list with Approve name and approval date, but these 2 columns are not available to copy. How should I do?
How can you prevent an approver from approving their own edits?