As a SharePoint site owner, you may need to ensure that every document added to a specific library automatically receives a retention label for compliance or record management. Without a default label, users must manually apply the correct label, which leads to inconsistent classification and potential data governance gaps. This article explains how to set a default retention label on a SharePoint document library and provides a practical checklist to follow. You will learn the prerequisites, the exact steps, and common pitfalls to avoid when applying the label.
Key Takeaways: Apply a Default Retention Label to a SharePoint Library
- Library Settings > Information management policy settings: Opens the policy configuration page where you select a retention label as the default for all new documents.
- Microsoft Purview compliance portal: Where you create and publish retention labels before they appear in SharePoint library settings.
- Label priority for existing files: Default labels apply only to new items. Existing files require a separate bulk label action or a Power Automate flow.
Understanding the Default Retention Label Feature
A default retention label is a setting applied at the library level that automatically assigns a specified label to every new document added to that library. The label can enforce retention rules, classify content as a record, or trigger a disposition review. This feature is part of Microsoft Purview Information Protection and requires specific licenses.
Before you can set a default label, the retention label must already exist and be published in the Microsoft Purview compliance portal. The label must be configured for automatic labeling based on a default library label. If the label is not published, it will not appear in the library settings dropdown.
Prerequisites for Using Default Retention Labels
To use default retention labels on a SharePoint library, you need the following:
- License: Microsoft 365 E5, Microsoft 365 E5 Compliance, or Microsoft 365 E5 Information Protection and Governance. Office 365 E5 also works.
- Permissions: You must be a SharePoint site owner or have at least the Manage Web Site permission. In the compliance portal, you need Compliance Administrator or Retention Manager roles.
- Label published: The retention label must be created and published to the desired location, such as all SharePoint sites or a specific site collection.
Step-by-Step Checklist to Apply a Default Retention Label
Follow these steps in order. Each step builds on the previous one.
- Create the retention label in the Microsoft Purview compliance portal
Go to Microsoft Purview compliance portal > Solutions > Information protection > Labels. Select Create a label and choose Retention. Configure the retention period, what happens at the end of the period, and whether the label marks content as a record. Complete the wizard and publish the label to the desired locations, such as all SharePoint sites or a specific site. - Verify the label is published
In the same compliance portal, go to Label policies. Confirm that a policy exists that includes your label and that the policy is assigned to the SharePoint site where your library resides. Wait up to 24 hours for the label to become available in SharePoint. - Navigate to the document library in SharePoint
Open the SharePoint site and go to the document library where you want to apply the default label. Click the gear icon (Settings) and select Library settings. - Open the information management policy settings
Under the Permissions and Management section, click Information management policy settings. This opens the policy configuration page for the library. - Enable the default retention label
On the policy page, find the section Retention or Labels. The exact label depends on your tenant configuration. Select the radio button for Apply a default label to items or Use a default label. From the dropdown, choose the retention label you created and published in step 1. - Save the policy
Click OK or Save to apply the setting. The default label is now active for all new documents added to this library. - Test the default label
Upload a new document to the library. After the upload completes, select the file and check its Properties or Details pane. The retention label should appear automatically. If it does not appear, wait a few minutes and refresh the page.
Common Mistakes and Limitations to Avoid
The label does not appear in the dropdown list
If you do not see your label in the library settings dropdown, the label is not published to the site. Go back to the compliance portal and verify that the label policy includes your SharePoint site. Publishing a label to all SharePoint sites covers all site collections. If you published to specific sites only, confirm the site URL is correct.
Default label does not apply to existing files
The default label setting applies only to new documents added after the policy is saved. Existing files in the library are not affected. To label existing files, use one of these methods:
- Bulk edit the files in the library and manually apply the label.
- Use a Power Automate flow that runs on a schedule to apply the label to all items.
- Use the Compliance admin center > Information protection > Labels and select Auto-apply a label to create a policy that labels existing content based on conditions.
Users cannot change the label after it is applied
If the retention label is configured to mark content as a record, users cannot modify or remove the label. This is by design. If you need users to be able to change the label later, create the label without the record setting. You can also set the label to allow modification by unchecking the option Lock the label during label creation.
Label conflicts with folder-level or item-level labels
SharePoint allows applying a default label at the library level and also manually applying labels at the folder or item level. If a user manually applies a different label to an item, that manual label overrides the default. To enforce the default label, use a compliance policy that blocks users from changing labels, or configure the label to be locked.
Library Default Label vs. Auto-Apply Label Policy: Key Differences
| Item | Library Default Label | Auto-Apply Label Policy |
|---|---|---|
| Scope | Single document library | All SharePoint sites or specific sites |
| Trigger | Item is added to the library | Item meets specific conditions (e.g., contains credit card number) |
| Existing files | Not affected | Can be applied to existing files if policy is set to scan |
| User override | Users can manually change label unless locked | Users can manually change label unless locked |
| Management | Library settings page | Microsoft Purview compliance portal |
You can now apply a default retention label to any SharePoint document library using the checklist above. Start by creating and publishing the label in the compliance portal, then configure the library settings. For existing files, use a Power Automate flow or an auto-apply policy. Remember that a locked label prevents users from changing it, which is useful for strict compliance scenarios.