Site owners often see a document locked in a retention hold and do not understand why they cannot delete or edit it. The hold is triggered by a Microsoft 365 retention policy or a litigation hold applied by a compliance administrator. This behavior protects content from permanent deletion or alteration during legal or regulatory obligations. This article explains exactly how retention holds work on SharePoint sites, what site owners can and cannot do, and provides a practical workflow for managing content under hold.
Key Takeaways: Retention Hold Behavior for SharePoint Site Owners
- Microsoft 365 compliance portal > Policies > Retention: Retention policies can apply a hold that prevents deletion and editing of SharePoint content.
- SharePoint site > Document library > Information pane: Site owners can check the hold status of a document to see if it is under retention.
- Microsoft 365 compliance portal > eDiscovery > Hold: A litigation hold applied to a site locks all content until the hold is released by a compliance officer.
How Retention Holds Work on SharePoint Sites
A retention hold in SharePoint is a lock applied to content by a retention policy or an eDiscovery hold. The hold prevents users from permanently deleting documents or modifying them in ways that would destroy the original version. The hold does not block normal editing in most cases, but it does block permanent deletion, overwriting, and metadata changes that would make the content unrecoverable.
The hold is enforced at the item level. When a document is under hold, SharePoint preserves the current version and all previous versions. If a user tries to delete the document, SharePoint returns an error message stating that the item is under retention hold. The same error appears if a user attempts to edit metadata fields that are protected by the hold, such as the document title or custom columns used for compliance.
Types of Retention Holds
There are two primary types of retention holds that affect SharePoint content. The first is a retention policy applied from the Microsoft 365 compliance portal. This policy can apply to all content in a site, a library, or specific folders. The second is a litigation hold applied through eDiscovery cases. A litigation hold locks all content in a mailbox or site until the hold is removed by a compliance administrator. Both types behave the same way for site owners: the content cannot be permanently deleted.
What the Hold Does Not Block
Site owners and users can still perform many actions on content under retention hold. They can view the document, check it out, edit it, and save new versions. They can move the document to another library within the same site, as long as the destination library is also covered by the same retention policy. They can also apply new metadata values that are not restricted by the hold. The hold only blocks actions that would permanently destroy the content or its compliance metadata.
Practical Workflow for Site Owners Managing Content Under Hold
This workflow helps site owners identify content under hold, understand why it is held, and take appropriate actions without breaking compliance rules. Follow these steps in order.
- Identify the document under hold
Open the document library in SharePoint. Select the document that shows the error when you try to delete it. In the details pane on the right, look for the section labeled Retention hold or Policy. If a hold is active, you will see the policy name and the hold type. - Check the retention policy details
Go to the Microsoft 365 compliance portal at compliance.microsoft.com. Select Policies > Retention. Find the policy name shown on the document details pane. Click the policy to view its scope and duration. This tells you how long the hold will last and whether it applies to the entire site or specific content. - Determine if the hold is from a litigation hold
If the document details pane shows eDiscovery hold instead of a retention policy name, the hold is from a litigation case. Go to the compliance portal and select eDiscovery > Core or Advanced. Look for an active case that includes the site. Contact the compliance officer who manages that case to understand the hold duration. - Work with the content while it is under hold
You can still edit the document, save new versions, and move it to another library within the same site. Do not attempt to delete the document or change metadata columns that are marked as required for compliance. If you need to delete the document for business reasons, submit a request to the compliance team to release the hold on that specific item. - Track the hold expiration date
Retention policies have a duration that is set when the policy is created. For example, a policy might hold content for 7 years after creation. After that period, the hold is automatically lifted and the content can be deleted normally. Check the policy configuration in the compliance portal to see the exact expiration rules.
Common Situations Site Owners Encounter
Cannot delete a document even though no policy is visible
If the document details pane does not show a retention policy name, but deletion is still blocked, the hold may be inherited from a parent site or a library. Check the site collection settings. Go to the site settings page and select Information management policy settings. If a policy is applied at the site level, all libraries inherit it. You may need to ask a compliance administrator to check the site-level policy.
Document shows retention hold after a site migration
When you move a site to a different tenant or restore it from a backup, the retention hold may be applied incorrectly. The hold is tied to the original content ID and policy assignment. After migration, the hold may persist on the original content but not on the new copy. Verify with the compliance team that the hold is correctly assigned to the correct site location.
User receives an error when editing metadata
Some metadata columns are protected by the retention hold if they are marked as compliance-related. For example, a column named Retention label or Record status is locked. The user cannot change the value in that column. If you need to update the metadata, ask the compliance team to remove the hold on that specific column or to create a new version of the document with the correct metadata.
Retention Hold vs. Record Status: Key Differences
| Item | Retention Hold | Record Status |
|---|---|---|
| Purpose | Prevents permanent deletion for compliance | Marks content as official record with restricted editing |
| Editing allowed | Yes, editing is allowed unless metadata is locked | No, records are read-only and cannot be edited |
| Deletion allowed | No, deletion is blocked until hold expires | No, deletion is blocked until record is declared inactive |
| Duration | Set by retention policy or litigation hold | Set by the record label or file plan |
| Who can remove | Compliance administrator only | Compliance administrator or record manager |
Site owners should understand that a retention hold is not the same as a record. A record imposes stricter restrictions, such as blocking all editing and deletion until the record is declared inactive. A retention hold only blocks permanent deletion and certain metadata changes.
Now you can identify retention holds on your SharePoint documents, determine the source of the hold, and follow the correct workflow to manage content without violating compliance rules. Next, review your site’s retention policies in the compliance portal to see which policies are active and when they will expire. A practical tip is to create a shared document with your compliance team that lists all active holds and their expiration dates so site owners can plan content cleanup accordingly.