Skip to content

Commit f04ff1e

Browse files
authored
Merge pull request #50539 from riswinto/main
update retention label unit
2 parents 4996066 + cb2dda3 commit f04ff1e

File tree

3 files changed

+40
-64
lines changed

3 files changed

+40
-64
lines changed

learn-pr/wwl-sci/purview-implement-manage-retention/create-publish-retention-label.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,12 @@ title: Create and publish retention labels
44
metadata:
55
title: Create and publish retention labels
66
description: "Create and publish retention labels."
7-
ms.date: 07/01/2024
7+
ms.date: 05/19/2025
88
author: wwlpublish
99
ms.author: riswinto
1010
ms.topic: unit
1111
azureSandbox: false
1212
labModal: false
13-
durationInMinutes: 8
13+
durationInMinutes: 6
1414
content: |
1515
[!include[](includes/create-publish-retention-label.md)]
Lines changed: 37 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -1,90 +1,66 @@
1-
Retention labels in Microsoft Purview allow you to specify how long items like documents or emails should be kept and when they should be deleted. This is important for meeting compliance requirements and managing organizational information efficiently.
1+
Retention labels in Microsoft Purview help you control how long to keep files and when to delete them. You can use them to meet regulatory requirements, manage risk, and improve how your organization handles information. Labels can be applied manually or automatically, and they're a key part of your data lifecycle strategy.
22

3-
## Understand File plan
3+
## Create a retention label
44

5-
File plan in Microsoft Purview Records Management enhances the creation and management of retention labels with advanced capabilities such as bulk actions and comprehensive overviews. It's designed for detailed management of records and non-record information across your organization.
5+
You can create a retention label either from the **Data Lifecycle Management** section or by using the **File plan** in **Records Management**. The main difference is that the file plan includes extra classification features like bulk actions, detailed overviews, and metadata tags (called descriptors). If you're managing just a few labels or don't need structured classification, you can create them directly in Data Lifecycle Management instead.
66

7-
### Key features of file plan
7+
### What is a file plan?
88

9-
- **Bulk creation and management**: Import and create multiple retention labels from a spreadsheet, allowing for efficient setup.
10-
- **Detailed overview**: View and manage detailed settings of all retention labels from a single interface.
11-
- **Enhanced descriptors**: Use file plan descriptors for extra categorization and organization of retention labels.
9+
A file plan is a structured way to manage retention labels across your organization. It gives you a centralized view of all your labels and lets you organize them by categories like department, function, or regulatory authority. File plans are especially helpful when you need to manage many labels or align your data governance practices with formal records management standards.
1210

13-
### Access requirements
11+
## Steps to create a retention label using file plan
1412

15-
Ensure you have the necessary permissions within the **Compliance Administrator** role group to create and manage retention labels. Alternative roles include **Retention Management** for active management and **View-Only Retention Management** for read-only access.
13+
1. Sign in to the [Microsoft Purview portal](https://purview.microsoft.com/?azure-portal=true) and select **Solutions** > **Records management** > **File plan**.
1614

17-
## Create and publish retention labels
15+
1. Select **Create a label** and give it a name.
1816

19-
There are some important steps to follow when you create and publish retention labels, from setting up the label to applying it across your organization's services like SharePoint or Exchange. Here's what you need to do:
17+
1. On the **Define file plan descriptors** page, you can tag the label with optional metadata like:
2018

21-
### Steps to create a retention label using file plan
19+
- **Business function or department**
20+
- **Category**
21+
- **Authority type**
22+
- **Provision or citation**
2223

23-
Creating retention labels involves defining retention or deletion periods and specifying conditions that trigger these actions. Here's how to create a label:
24+
:::image type="content" source="../media/file-plan-descriptors.png" alt-text="Screenshot showing the Define file plan descriptors for this label page."::: with optional metadata like:
2425

25-
1. Navigate to **File plan** in either the Microsoft Purview portal or Microsoft Purview compliance portal:
26+
1. Choose what happens to content with this label:
2627

27-
- **Microsoft Purview portal**: [Sign in to the Microsoft Purview portal](https://purview.microsoft.com/?azure-portal=true) > **Records management** card > **File plan**.
28+
- Retain forever or for a specific time
29+
- Retain then delete
30+
- Just label for classification without retention or deletion
2831

29-
- If you don't see the **Records management** card, select **View all solutions** and find **Records management** under the **Risk & Compliance** section.
32+
1. If you selected retention, choose the length of time and what happens when that time ends.
3033

31-
:::image type="content" source="../media/purview-portal-records-management-card.png" alt-text="Screenshot showing the Records Management card in the Microsoft Purview portal.":::
34+
1. Review and finish your configuration.
3235

33-
- **Microsoft Purview compliance portal**: [Sign in to the Microsoft Purview compliance portal](https://compliance.microsoft.com/?azure-portal=true) > **Solutions** > **Records management** > **File plan**.
36+
## Publish a retention label
3437

35-
1. Select **Create a label** to start the **Create retention label** configuration, and name your new retention label.
38+
To make your label available to users or apply it across your Microsoft 365 services, you need to publish it through a retention label policy.
3639

37-
1. On the **Define file plan descriptors for this label** page:
40+
1. In the file plan, find your label and select the **Publish labels** icon (:::image type="icon" source="../media/publish-retention-label-icon.png":::).
3841

39-
- Review and categorize the retention label using predefined descriptors such as **Business function/department**, **Category**, **Authority type**, and **Provision/citation**.
42+
1. Choose whether the policy uses an adaptive or static scope.
4043

41-
:::image type="content" source="../media/file-plan-descriptors.png" alt-text="Screenshot showing the Define file plan descriptors for this label page.":::
44+
- **Adaptive scope**: Uses dynamic membership based on user or site attributes. Make sure the scope already exists.
45+
- **Static scope**: Lets you manually choose locations like Exchange mailboxes or SharePoint sites.
4246

43-
- Select or create descriptors:
47+
1. Select the specific services or locations where the label should be available.
4448

45-
- Select **Choose** to select appropriate descriptors that match the content management needs.
49+
1. Name your policy and finish setup.
4650

47-
- If needed, select **Create new** to add a custom descriptor, provide its details, and confirm.
51+
> [!NOTE]
52+
> Retention label policies can't be scoped using administrative units. If you need to scope retention settings by administrative unit, consider using a retention policy instead.
4853
49-
- Review and ensure your descriptors accurately reflect the label’s governance role within your organization.
54+
## When the label becomes available
5055

51-
1. On the **Define label settings**, choose one of the configurations for managing your content over a specified period:
56+
Retention labels don't appear immediately and might take up to seven days to propagate across services:
5257

53-
- **Retain items forever or for a specific period**: Retain items indefinitely or for a set time. After this time, retention settings can be deactivated.
54-
55-
- **Enforce actions over a specific period**: Retain items for a defined period. After this time, actions like automatic deletion or initiation of a disposition review are enforced.
56-
57-
- **Just label items**: Labels are used only for classification without enforcing any retention or deletion actions.
58-
59-
1. If **Retain items forever or for a specific period** or **Enforce actions over a specific period** was selected in the previous step, **Define the retention period** and **Choose what happens after the period**.
60-
61-
1. Review your settings and finish the **Create retention label** configuration.
62-
63-
### Steps to publish the retention label
64-
65-
After creating the label, you need to publish them through a retention label policy, which makes them available to users in your organization to classify and manage content.
66-
67-
1. Return to **File plan** from either the [Microsoft Purview portal](https://purview.microsoft.com/?azure-portal=true) or [Microsoft Purview compliance portal](https://compliance.microsoft.com/?azure-portal=true).
68-
69-
1. Select the retention label you'd like to publish and select the **Publish labels** icon (:::image type="icon" source="../media/publish-retention-label-icon.png":::) to start the configuration to publish your retention label.
70-
71-
1. On the **Assign admin units** page, if your organization uses administrative units, assign the policy to specific units to restrict its application to designated users or departments.
72-
73-
1. Select the scope type for your retention policy.
74-
75-
1. On the **Choose where to publish labels** page select either **All locations** or **Let me choose specific locations**.
76-
77-
1. Give your policy a unique name, and submit your changes to create your retention label policy and complete the configuration.
78-
79-
## When retention labels become available to apply
80-
81-
The visibility of retention labels can vary based on the service:
58+
:::image type="content" source="../media/retention-labels-published-timings.png" alt-text="Diagram illustrating when retention label policies are available to apply.":::
8259

83-
- **SharePoint and OneDrive**: Labels usually appear within one day, but it can take up to seven days.
84-
- **Exchange**: Labels can take up to seven days to appear and require the mailbox to have at least 10 MB of data.
60+
- **SharePoint and OneDrive**: Usually visible within 24 hours but can take up to 7 days
8561

86-
:::image type="content" source="../media/retention-labels-published-timings.png" alt-text="Diagram illustrating when retention label policies are available to apply.":::
62+
- **Exchange**: Can take up to 7 days; the mailbox must have at least 10 MB of data
8763

88-
If labels don't appear as expected, verify the policy status and consider using PowerShell commands to troubleshoot or force policy distribution.
64+
If your labels don't appear, double-check that the policy is active. You can also use PowerShell to verify status or force distribution.
8965

90-
Retention labels are an important feature of Microsoft Purview, ensuring data is managed according to policies and regulations. Creating and publishing these labels helps strengthen your organization's data management strategy and ensures compliance across all digital content.
66+
Retention labels help ensure your organization's data is kept as long as needed and removes it when it's no longer needed. Whether you're managing content manually or automating retention across services, labels give you the control and visibility to manage data confidently.

learn-pr/wwl-sci/purview-implement-manage-retention/index.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ uid: learn.wwl.purview-implement-manage-retention
33
metadata:
44
title: Implement and manage retention with Microsoft Purview
55
description: "Implement and manage retention with Microsoft Purview."
6-
ms.date: 07/01/2024
6+
ms.date: 05/19/2025
77
author: wwlpublish
88
ms.author: riswinto
99
ms.topic: module

0 commit comments

Comments
 (0)