Skip to main content
< All Articles

How to set up a Disposition review for content under Retention in SharePoint Online

Posted on August 21, 2024
SharePoint

Every time you set up a Label Retention Policy, you must specify what will happen at the end of the retention period. You can end the retention, delete the labeled content, or change the label to another label. However, you can also involve your compliance/regulatory officers or knowledge managers to manually review the labeled content and make the proper decision via the built-in feature of Disposition review. So, in this article, I would like to explain how to set up a Disposition review for content under Retention in SharePoint Online.

Components of the Disposition Review

Before we set up the Disposition Review, it is essential to understand the components involved.

Component # 1: Stages

Stages are possible in different phases of the review. You can have anywhere between 1 and 5 stages. For example, in most cases, you might want a Department Owner to review the labeled content. So, in this case, 1 stage is all you need. However, in some cases, you might want to have a serial review. Stage 1 could be Department Owners; Stage 2 could be Compliance Officers. Stage 3 could be the Legal Department and so on. The number of Stages and their names are set when you create a disposition review.

Component # 2: Approvers

Approvers are those who will review and decide on the action when they receive a disposition email. You can have one or more approvers, and they are assigned to the appropriate stage above during the disposition review setup in Purview.

Component # 3: Auto-approval

There is an auto-approval mechanism available. This might be handy if the approver does not take proper action within a designated number of days. With Auto-approval enabled, the process automatically proceeds to the next stage.

Component # 4: Disposition Email

When it is time to act on labeled content, Approvers receive emails asking them to decide on disposition. Those emails can be customized, and I will explain it later in this post

Component # 5: Disposition Tab in Purview

Approvers can also access the disposition dashboard in Purview. Again, instructions to follow.

How to set up a Disposition review for content under Retention in SharePoint Online

    1. Once in Microsoft Purview Data lifecycle management, create a new labelMicrosoft Purview Data lifecycle management Labels tab with the Create a label button highlighted
    2. Give your label a name, and click Next.Name your retention label page with the label name 2-Day Retention entered and Next button
    3. Specify that you want to retain content, click NextDefine label settings with Retain items forever or for a specific period selected, Next arrow
    4. Define the retention period. For this post, I am choosing 2 days from the date the item was created. Click Next.Define the retention period page set to 2 days, starting when items were created
    5. On the next screen, you must choose what happens after the retention period ends. This is where you choose the Start a disposition review option.Retention end options with Start a disposition review selected and Create stages link
    6. As soon as you select the Disposition option, you can create the stages and approvers I explained above.  In my example, I am creating 2 Stages: Stage 1 (Department Review) with Mary being the Approver + Stage 2 (Compliance Officer Review) with John being the Approver. Click Add a stage.Disposition review
    7. Name the stage, and click OK.Add a stage dialog with Department Review entered as the stage name
    8. Click Add another stage to add a second stage (if applicable)Disposition review
    9. Name the second stage, add its approver, and repeat for other stages (if appropriate). If not, click OK.Disposition stages page listing Department Review and Compliance Officer Review with their reviewers
    10. Once you set up Stages and Approvers, click Next.Disposition review
    11. Review the settings on the final screen; if everything looks OK, click the Create label.Review and finish page showing label settings and two disposition stages, with Create label button
    12. You will receive a confirmation message that the label was created. After continuing the setup, you can publish it.Retention label created confirmation with the option to publish the label to Microsoft 365 locations
    13. Click Next.Choose labels to publish page listing the 2-Day Retention label with the Next button
    14. Add Admin Units if applicable. To learn more about Admin Units, check out this article. Click Next.Policy Scope page for admin units showing Full directory and the Next button
    15. Choose between Static or Adaptive scope. Click Next.Retention policy type page with Static scope selected and Next button highlighted
    16. In my case, I chose Static Scope. Choose the site(s)to apply the retention label to. Click Next.Retention policy location settings with Microsoft 365 Group mailboxes and sites turned on
    17. Name the policy, and click Next.Name your policy page with 2-Day Retention entered as the policy name
    18. Review the settings and click Submit to publish the policy.Finish page summarizing the label policy settings with the Submit button highlighted
    19. You will receive a confirmation message.Confirmation message that the retention label was published to users within a week
    20. Once the label is published to the site, apply the label to file(s) and folders.Disposition review

Experience for the Approvers

  1. Once the retention period ends and the disposition review kicks in, the approvers you defined in the Stages above will start getting emails like the ones below.Disposition review
  2. When they click on a link in the email, they are rerouted directly to the Disposition Page within Microsoft Purview.Purview Pending dispositions list showing Test Doc 3 and Test Doc 1 from SharePoint
  3. As a reviewer/approver, you will have 4 choices to choose from: Approve disposal, Relabel, Extend and Add reviewers.Disposition review
  4. If you decide to Approve disposal, you must enter comments and click Apply.Approve disposal dialog with a required comment entered and the Apply button
  5. If you decide to Relabel, you must choose a new label and click Apply.Disposition review
  6. If you decide to Extend, you must choose the extension duration and click Apply.Extend disposition date dialog with dropdown of 3 months, 6 months, 1 year, Custom
  7. If you decide to Add reviewers, you will need to choose the names of additional reviewers and click Add.Disposition review

Important Notes

  • Reviewers must have proper access and licenses to Microsoft Purview. If they do not, they will get error messages when accessing the Disposition Review Page.Client Error message saying the user lacks permissions to view the Purview Disposition page
  • Specifically, reviewers will need to be part of the Disposition Management role.Disposition review
  • Reviewers will also need to be part of the Content Explorer Content Viewer role to view content from the sites.Disposition item preview requiring the Content Explorer Content Viewer role, with review action buttons
  • Even a Global Microsoft 365 Admin isn’t granted the Disposition Management and Content Viewer roles above by default. They would then need to be assigned manually. Microsoft has some excellent instructions here.
  • It will also help if Reviewers have access to the site(s) where the content resides
  • If you do not want to have some reviewers as bottlenecks, you can enable Automatic Stage Approval toggle switch when you define stages and approvers – this will allow you to automatically proceed to the next stage if the approver fails to take action during the specified period
  • You can also customize email messages sent to approvers at the end of the retention period or at the start of the disposition process. Microsoft provides instructions on this.
Gregory Zelfond, the SharePoint Maven - profile photo

About Me

I’m Greg Zelfond, a U.S. based SharePoint consultant, and I provide affordable out-of-the-box SharePoint consulting, training, and configuration assistance to small and medium-sized businesses all over the world.

Need help?