Retention Label Blocks File Deletion: Fix
🔍 WiseChecker

Retention Label Blocks File Deletion: Fix

When you try to delete a file in SharePoint or OneDrive, you may see an error stating that the file cannot be deleted because it has a retention label applied. This happens because the retention label enforces a policy that prevents permanent deletion during the retention period. The label is tied to a retention policy in the Microsoft Purview compliance portal, which overrides standard delete permissions. This article explains why retention labels block deletion and provides the exact steps to remove the label or adjust the policy so you can delete the file.

Key Takeaways: Removing a Retention Label That Blocks Deletion

  • Microsoft Purview compliance portal > Data Lifecycle Management > Labels: The central location to view and remove retention labels applied to files.
  • SharePoint site permissions: You must be a site owner or have at least Edit permissions to change a label on a file.
  • Retention policy duration: If the label is locked or part of a regulatory policy, you may need to wait until the retention period expires or contact your compliance admin.

ADVERTISEMENT

Why a Retention Label Prevents File Deletion

A retention label is a tag applied to a file or email that tells SharePoint or OneDrive how long to keep the item and what action to take at the end of that period. When a label is set to retain the file permanently or for a specific duration, the system blocks any user action that would permanently delete the content. This includes deleting the file from a document library, emptying the recycle bin, or using a SharePoint Designer workflow that removes the item.

The root cause is that the retention label enforces a preservation lock or a retention rule defined in Microsoft Purview. Even if you have Full Control permissions on the site, the label’s policy takes precedence. The file remains in a protected state until one of the following conditions is met:

  • A compliance administrator removes the retention label from the file.
  • The retention period expires, and the label’s disposal action is triggered.
  • The label is part of a policy that allows deletion after a review (adaptive or static).

It is important to understand that retention labels are not the same as sensitivity labels. Sensitivity labels control access and encryption, but they do not block deletion. Retention labels are specifically designed for information governance and legal compliance.

Steps to Remove a Retention Label and Delete the File

Follow these steps to remove the retention label from the file. You need at least Edit permissions on the file and access to the Microsoft Purview compliance portal. If you are not a compliance administrator, request help from your organization’s compliance team.

  1. Identify the retention label applied to the file
    Open the SharePoint document library or OneDrive folder where the file is stored. Select the file and look at the Details pane on the right side. Under Retention label, note the name of the label. If the Details pane is not visible, click the i icon in the top-right corner of the library.
  2. Sign in to the Microsoft Purview compliance portal
    Go to compliance.microsoft.com and sign in with an account that has the Compliance Administrator or Records Management role. If you do not have these roles, ask your global administrator to assign them.
  3. Navigate to the label management page
    In the left navigation menu, select Data Lifecycle Management > Labels. A list of all retention labels in your tenant appears. Find the label you noted in step 1. You can use the search box at the top to filter by name.
  4. Check the label’s policy settings
    Click the label name to open its details. Under Label settings, look for Retention period and Disposition review. If the label is set to Retain items permanently, it will block deletion indefinitely. If it has a fixed period, note the end date. Also check if the label is locked. A locked label cannot be removed or changed by anyone except a compliance administrator with elevated privileges.
  5. Remove the label from the file using Content Search
    In the Purview portal, go to Content Search > Search. Create a new search with the file name or URL. After the search completes, select the file and click Export results to verify the file is indexed. Then go to Records Management > File plan > Label actions. Choose Remove label and follow the wizard to target the specific file. This action removes the retention label without affecting the file’s content.
  6. Delete the file from SharePoint
    Return to the SharePoint library. Select the file and click Delete on the toolbar. If the label was successfully removed, the file moves to the recycle bin. To permanently delete it, go to the Recycle Bin and delete it again. If the deletion is still blocked, the label may have been reapplied by a policy. Check the file’s properties again.

ADVERTISEMENT

If SharePoint Still Blocks Deletion After Removing the Label

“The file is still protected by a retention policy”

This error appears when the retention label is part of a default label policy that automatically applies the label to all files in a library or site. Even if you remove the label from one file, the policy reapplies it within a few minutes. To fix this, you must either:

  • Change the default label policy to exclude the specific library or site. Go to Purview > Data Lifecycle Management > Policies, edit the policy, and modify the scope.
  • Wait for the retention period to expire if the label is locked.

“You do not have permission to remove this label”

This error means your account lacks the Records Management role or the Compliance Administrator role. Only users with those roles can remove retention labels via Content Search. Contact your compliance team and ask them to perform step 5 above. Alternatively, ask them to grant you the Records Management role temporarily.

“The retention label is locked and cannot be removed”

A locked retention label is used for regulatory or legal requirements. It cannot be removed, changed, or deleted by anyone, including global administrators. The only way to delete the file is to wait until the retention period expires. If the label is set to retain items permanently, the file can never be deleted. In that case, consult your legal or compliance department to determine if an exception process exists.

Retention Label That Blocks Deletion vs Sensitivity Label: Key Differences

Item Retention Label Sensitivity Label
Primary purpose Prevent deletion or modification for a set period Encrypt and restrict access to files
Blocks file deletion Yes, during the retention period No, only blocks access without decryption
Applied automatically Via default label policy or auto-labeling rules Via sensitivity policy or manually by user
Can be removed by user Only by compliance admins via Content Search By the file owner or user with sufficient rights
Locked option available Yes, for regulatory compliance No

You can now identify why a retention label blocks deletion and follow the steps to remove it or work around the policy. Check the label’s lock status before attempting removal. If the label is locked, plan for the retention period to expire. For files that must be deleted immediately, contact your compliance administrator to verify if an exemption or manual override is possible under your organization’s data governance rules.

ADVERTISEMENT