You can use modern approvals in lists to create approval requests for list items, respond to approval requests, and view the approval status for list items.

Getting started

Modern approvals are pre-configured if a list is created from selected built-in list templates. These built-in list templates are:

  • Content scheduler with approvals

  • Travel requests with approvals

Simply create a list from one of the above templates to get started.screenshot of list templates with approvals

Alternatively, you can enable or disable modern approvals in any list by going to the Automate dropdown and selecting Configure Approvals. The dialog will provide a switch to enable and disable at any time.

1. Navigate to the command bar Automate dropdown and select Configure Approvals.

Dropdown menu with Configure Approvals option

2. Select the toggle for Enable Approvals and hit Apply.

Dialog option to Enable Approvals

3. To disable Approvals at any time you can again navigate to the Automate dropdown, select Configure Approvals and click the toggle.

Note: disabling approvals will only hide the related approvals columns. Active approvals will still be actionable in Teams and you can re-add the columns to a view at any time.

Dialog menu with toggle to disable Approvals feature

Create a modern approval request on a list item

  1. On a list, select an item and select Request approval from the contextual menu to open the approvals dialog box. Alternatively, you can select the status pill of that item under the Approval status column to open the approvals dialog box.Screenshot of the Content scheduler dialogues box in Microsoft Lists.

  2. Enter one or more approvers in the Approver(s) field. By default, if any approver approves the request, the approval request is considered to be granted. If needed, you can also select the toggle below to require a response from all approvers. You can also add details about the approval request.Screenshot displaying the Request approval dialog box. Once an approval request is created for an item, the status pill will change to Requested.

Respond to an approval request on a list item

From a list:

  1. Select the list item that you wish to respond to an approval request and select Approval details from the contextual menu. Alternatively, you can select the status pill of that item under the Approval status column. ​​​​​​​ screenshot of where to see approval details

  2. In the approvals dialog box, you can select Approve or Reject for the request as needed. If you requested this approval, you will also see an option to Cancel request. Screenshot displaying the Approval request details dialogue box.

From the Approvals app in Teams:

  1. Go to the Approvals app in Microsoft Teams.

  2. Identify and select the approval request in the list of requests.

  3. In the approvals dialog box, you can select Approve or Reject to the request as needed. If you requested this approval, you will also see an option to Cancel request under More actions. You can also Follow up or Reassign the approval request when you click on More actions. Screenshot of the Approval request details on the App.

See the approval history for a list item

From a list:

  1. Select the list item that you wish to respond for an approval request and select Approval details from the contextual menu. Alternatively, you can select the status pill of that item under the Approval status column.Screenshot of Approval history in Lists.

From the Approvals app in Teams:

  1. Go to the Approvals app in Microsoft Teams.

  2. Identify and select the approval request in the list of requests.Screenshot of Approval history of list items on app.

Limitations of modern approvals on lists

User Experience

  • If an approver does not have permission to view a list item, sending an approval request to that user does not automatically share the underlying list item with that person. The approver must be granted access to the list item manually.

  • Approval requests are auto cancelled, if the underlying list item changes (i.e. edited or deleted). Users will receive a warning that there is an active approval and it will cancel the request if edits are completed.

    Note: In this case, the system will note the user who created the approval request as the user who cancelled the request.

  • To see and manage approvals whether you are the requestor or approver, go to the Approvals app in Teams.

Availability

  • Modern approvals is not yet available on document libraries.

  • In grid view, you can only request approvals, but you can respond to approval request from the command bar.

Effects on other features

  • If modern approvals is enabled on a list, Lists sync is automatically turned off for that list.

  • List rules can use the Approval status column, however certain conditions and filter criteria may not have a valid user in the designated field to send an email from the rule.

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.