Removing a Retention Policy published to SharePoint in Office 365

Reading Time: 2 minutes

If a Retention policy is enabled and actively retaining content and you want to stop using it, how can you safely do this? I tested this out by setting up a Retention policy to retain content against a SharePoint site and made changes to some content in the site so the Preservation Hold library (PHL) was provisioned and storing content. 

Caution: this is a common requirement when you’re testing retention policies to ensure your cleaning up after testing. If you’re doing this in a production environment where you’re retaining production content, be aware of what this can do to content being retained.

Reference for retention policies in Office 365: Overview of retention policies

Option 1: Toggle the ‘On’ button to ‘Off’ for the Retention policy 

After doing this, the policy will initially go into an Off(Pending) status. I waited for a short period of time (< 15 minutes), and the status went to Off(Success). I ensured the Retention policy was no longer in effect by making a change to a document and verifying nothing was added to the PHL. The PHL will remain on the site for a (by default) 30-day grace period (can be changed by PowerShell) after which the content will be deleted and will follow normal Recycle bin processing from that point

Note: the PHL will remain, only the content within it will be deleted.

Conversely, if you want to re-enable the Retention policy again and continue preserving the content, you can switch the status to ‘On’. Once the status is On(Success), the Retention policy will resume its work on all published locations and content will again be retained in the PHL. If you are within the 30-day grace period, the pre-existing PHL content will remain. 

Option 2: Delete the Retention policy without toggling the button to ‘Off’ first 

Rather than turning the policy ‘Off’, what happens if you delete the Retention policy while it’s still in an On(Success) status? When deleting the policy, it will pop open a confirmation window. If you select ‘yes’, the Retention policy will be deleted! After a few minutes (< 15 minutes in my case), the Retention policy is deleted and the PHL will no longer be updated. I also confirmed with PowerShell that the Retention policy was gone via the Get-RetentionCompliancePolicy cmdlet. 

What happens to the content on the site once the Retention policy is disabled/deleted? 

Assuming there are no other Retention policies in effect, the content on the site, including the PHL will remain and the PHL will no longer be updated for a 30-day grace period. After this grace period, the PHL content will follow normal Recycle bin processing from that point.

What is the recommended way to remove a Retention policy? 

If you want to keep the Retention policy definition around, then deactivating it is a smart choice. If you don’t care, it doesn’t appear to make a difference if you disable the Retention policy prior to deleting it… eventually the policy is disabled/deleted and the PHL content will be cleaned up within the grace period defined. 

Thanks for reading.


Credit: Photo by Fernando Arcos from Pexels


  1. You said you can change the 30 days of grace period by PowerShell

    I’m wondering if you know the script for that

      1. Hi Urs, I don’t know off the top of my head. I’ll update the post when I find that out.

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.