Changing "retention type" on an existing retention label in MS Purview

Frequent Visitor

I have a need to make a change to document retention in SharePoint. I need to deprecate use of an existing retention label with retention type "EventAgeInDays" and have users begin labeling content based on a retention type of "TaggedAgeinDays" instead. The shortcut appears to be simply modifying the existing label in the FilePlan. It appears to solve for a number of issues like having to retrain the users to pick a new label name. I have tried the change in my development tenant, and I received no errors. I presume the content labeled before the change will continue with the old parameters of the label. Only newly labeled content would get the change. This seems almost too easy. Is there a preferred way to handle such an alteration? Did I just light the fuse on a process that is bound to fail when SharePoint runs the weekly housekeeping?

1 Reply

Hi @K-dub,


Thanks for the question! Here is a link to the documentation about modifying existing labels: Create retention labels for exceptions - Microsoft Purview (compliance) | Microsoft Learn

"Most settings can't be changed after the label is created and saved, which include:

  • The retention label name and the retention settings except the retention period. However, you can't change the retention period when the retention period is based on when items were labeled."

So, you can change the retention period for a label, but nothing else. If you'd like to change the other settings, the best process is to create a new label and use PowerShell to replace it 1:1 with the old label.


Please let us know if you have other questions.