When you cannot delete a file from a SharePoint document library, a retention label applied to that file is often the cause. SharePoint retention labels enforce rules that prevent permanent deletion of content before a specified period ends. This feature is designed to help organizations meet legal and regulatory requirements. In this article, you will learn how to identify whether a retention label is blocking deletion and what site owners can do to resolve the issue without breaking compliance rules.
Key Takeaways: How Retention Labels Block File Deletion
- SharePoint retention label policies: Prevent permanent deletion of labeled files until the retention period expires.
- File information panel: Check the “Retention” tab to see if a label is applied and its disposition status.
- PowerShell Get-RetentionComplianceRule: Retrieve the exact retention rule that applies to a label and its deletion block duration.
Why a Retention Label Blocks File Deletion
A retention label is a tag that you apply to a SharePoint item or library to control how long the content must be kept. When a label is set to “retain” content for a specific duration, SharePoint prevents users from permanently deleting that item until the retention period ends. The file can still be moved or edited, but the Delete command either fails silently or produces an error message such as “You don’t have permission to delete this item” or “The item is protected by a retention policy.”
The retention label itself is defined in the Microsoft 365 Compliance Center and can be published to SharePoint sites automatically or applied manually by users. The label’s settings determine whether retention is triggered by the item’s creation date, last modified date, or a custom date. Until the trigger date plus the retention period passes, the file is locked against deletion.
How the Label Interacts with SharePoint Permissions
Retention labels override standard SharePoint permissions. Even if a user has Full Control or Site Owner permissions, they cannot permanently delete a file that has an active retention label. This is intentional: it prevents accidental or malicious deletion of records that must be preserved. The only way to delete such a file is to either wait for the retention period to expire or to remove the retention label if your compliance policy allows it.
Steps to Check Whether a Retention Label Is Blocking Deletion
Follow these steps to identify if a retention label is the reason a file cannot be deleted.
- Select the file in the document library
Click the circle next to the file name to select it. Do not open the file. - Open the file information panel
Click the information icon (the letter “i” in a circle) in the top-right corner of the library toolbar. The panel opens on the right side of the screen. - Check the Retention section
Scroll down in the panel to find the “Retention” heading. If a retention label is applied, you will see the label name and the status. A status of “Active” or “Pending” means the file is protected and cannot be deleted. - Look for a deletion error message
Try to delete the file by selecting it and clicking Delete on the toolbar. If you see an error that mentions “retention policy” or “retention label,” the label is the cause. - Verify the label details in the Compliance Center
Go to the Microsoft 365 Compliance Center at compliance.microsoft.com. Navigate to Information governance > Labels. Find the label name you saw in the file information panel. Click the label to view its retention settings, including the retention period and what happens after the period ends.
What to Do When a Retention Label Blocks Deletion
As a site owner, you have limited options to remove a retention label. The label is managed by compliance administrators, not by site owners. Here are the actions you can take.
Option 1: Wait for the Retention Period to Expire
If the retention period is short, the file will become deletable automatically after the period ends. Check the label’s retention duration in the Compliance Center. For example, if the label retains content for 30 days from creation, the file can be deleted after day 31.
Option 2: Request Label Removal from a Compliance Admin
Contact your organization’s compliance administrator and ask them to review the label. They can remove the label from the file if the business requirement no longer applies. The admin uses the Microsoft 365 Compliance Center to edit the label policy or manually delete the label from the item.
Option 3: Use PowerShell to Identify the Label and Its Rule
Site owners with the SharePoint Online Management Shell can run PowerShell commands to find which retention rule applies to a label. This helps you provide exact details to the compliance team.
- Connect to the Security and Compliance Center
Open PowerShell and runConnect-IPPSSession. Sign in with your admin credentials. - Get the retention rule for a specific label
RunGet-RetentionComplianceRule | Where-Object {$_.Mode -eq 'Enforce'} | Format-Table Name, Policy, Modeto list all enforced rules. Note the rule name that matches the label you saw. - Check the retention duration
RunGet-RetentionComplianceRule -Identity "rule name" | Format-List. Look for theRetentionDurationproperty. This tells you the number of days the file is retained.
Common Misconceptions About Retention Labels and Deletion
“I am a site owner, so I should be able to delete any file”
Site owner permissions do not override retention labels. Retention is a compliance feature that sits above SharePoint permissions. Even global admins cannot delete a file with an active retention label unless they remove the label first.
“The file is in the recycle bin, so it should be deletable”
When a file with a retention label is moved to the recycle bin, the label stays applied. The file remains undeletable until the retention period expires. The recycle bin does not bypass retention policies.
“I can delete the file if I change the retention label”
Changing the label on a file does not immediately allow deletion. The new label must have a retention period that has already expired, or the new label must be set to “no retention.” If the original label is still active, the file remains protected.
Retention Label vs Retention Policy: Key Differences
| Item | Retention Label | Retention Policy |
|---|---|---|
| Scope | Applied to individual items or libraries | Applied to entire sites, mailboxes, or other locations |
| User interaction | Users can manually apply labels or auto-apply via rules | Automatic; users cannot see or change the policy |
| Deletion blocking | Blocks permanent deletion of the labeled item | Blocks deletion of all content in the policy scope |
| Management location | Microsoft 365 Compliance Center > Information governance > Labels | Microsoft 365 Compliance Center > Information governance > Policies |
As a site owner, you now know how to identify a retention label that blocks file deletion. Check the file information panel first to see the label name and status. If the file must be deleted urgently, contact your compliance administrator to review the label. Use PowerShell to gather exact retention rule details before escalating. Remember that retention labels exist to protect business records, and bypassing them without authorization can violate compliance policies.