Retention tags and retention policies in Exchange Online

Important

Please refer to the Microsoft 365 security center and the Microsoft Purview compliance portal for Exchange security and compliance features. They are no longer available in the new Exchange admin center.

Note

To proactively retain or delete mailbox content for information governance in Microsoft 365, we recommend that you use retention policies and retention labels from the Microsoft Purview compliance portal, instead of messaging records management that's described on this page. However, you should continue using messaging records management to move messages to archive mailboxes.

If you currently use messaging records management, this older feature will continue to work side-by-side with retention policies and retention labels. However, we recommend that going forward, you use retention policies and retention labels instead. They provide you with a single mechanism to centrally manage both retention and deletion of content across Microsoft 365.

In Microsoft Exchange Server and Exchange Online, Messaging records management (MRM) helps organizations to manage email lifecycle and reduce legal risks associated with e-mail and other communications. MRM makes it easier to keep messages needed to comply with company policy, government regulations, or legal needs, and to remove content that has no legal or business value.

Watch this video for a quick overview of how to apply retention tags and a retention policy to a mailbox in Exchange Online.

Messaging Records Management strategy

MRM in Exchange Server and Exchange Online is accomplished by using retention tags and retention policies. Before discussing the details about each of these retention features, it's important to learn how the features are used in the overall MRM strategy. This strategy is based on:

  • Assigning retention policy tags (RPTs) to default folders, such as the Inbox and Deleted Items.

  • Applying default policy tags (DPTs) to mailboxes to manage the retention of all untagged items.

  • Allowing the user to assign personal tags to custom folders and individual items.

  • Separating MRM functionality from users' Inbox management and filing habits. Users aren't required to file messages in managed folders based on retention requirements. Individual messages can have a different retention tag than the one applied to the folder in which they're located.

The following figure illustrates the tasks involved in implementing this strategy.

Using Retention Policies for Messaging Retention.

Retention tags

As illustrated in the preceding figure, retention tags are used to apply retention settings to folders and individual items such as e-mail messages and voice mail. These settings specify how long a message remains in a mailbox and the action to be taken when the message reaches the specified retention age. When a message reaches its retention age, it's moved to the user's archive mailbox or deleted.

The following example picture is for Exchange Server, although you can configure the same settings for Exchange Online:

Settings in a retention tag.

Retention tags allow users to tag their own mailbox folders and individual items for retention. Users no longer have to file items in managed folders provisioned by an administrator based on message retention requirements.

Types of retention tags

Retention tags are classified into the following three types based on who can apply them and where in a mailbox they can be applied.

Type of retention tag Applied... Applied by... Available actions... Details
Default policy tag (DPT) Automatically to entire mailbox
A DPT applies to untagged items, which are mailbox items that don't have a retention tag applied directly or by inheritance from the folder.
Administrator Move to archive
Delete and allow recovery
Permanently delete
Users can't change DPTs applied to a mailbox.
Retention policy tag (RPT) Automatically to a default folder
Default folders are folders created automatically in all mailboxes, for example: Inbox, Deleted Items, and Sent Items. See the list of supported default folders in Default folders that support Retention Policy Tags.
Administrator Delete and allow recovery
Permanently delete
Users can't change the RPT applied to a default folder.
Personal tag Manually to items and folders
Users can automate tagging by using Inbox rules to either move a message to a folder that has a particular tag or to apply a personal tag to the message.
Users Move to archive
Delete and allow recovery
Permanently delete
Personal tags allow your users to determine how long an item should be retained. For example, the mailbox can have a DPT to delete items in seven years, but a user can create an exception for items such as newsletters and automated notifications by applying a personal tag to delete them in three days.

More about personal tags

Personal tags are available to Outlook and Outlook on the web (formerly known as Outlook Web App) users as part of their retention policy. In Outlook and Outlook on the web, personal tags with the Move to Archive action appear as Archive Policy, and personal tags with the Delete and Allow Recovery or Permanently Delete actions appear as Retention Policy, as shown in the following figure.

Personal tags in Outlook 2010 and Outlook on the web.

Users can apply personal tags to folders they create or to individual items. Messages that have a personal tag applied are always processed based on the personal tag's settings. Users can apply a personal tag to a message so that it's moved or deleted sooner or later than the settings specified in the DPT or RPTs applied to that user's mailbox. You can also create personal tags with retention disabled. This allows users to tag items so they're never moved to an archive or never expire.

Note

Users can apply archive policies to default folders, user-created folders or subfolders, and individual items. Users can apply a retention policy to user-created folders or subfolders and individual items (including subfolders and items in a default folder), but not to default folders.

Users can also use the OWA settings dialog to select additional personal tags that aren't linked to their retention policy. The selected tags then become available in Outlook and Outlook on the web. To enable users to select additional tags via OWA, you must add the MyRetentionPolicies Role to the user's role assignment policy. To learn more about role assignment policies for users, see Role assignment policies in Exchange Online. If you allow users to select additional personal tags, all personal tags in your Exchange organization become available to them.

Note

Personal tags are a premium feature. Mailboxes with policies that contain these tags (or as a result of users adding the tags to their mailbox) require an Exchange Enterprise client access license (CAL).

Retention age

When you enable a retention tag, you must specify a retention age for the tag. This age indicates the number of days to retain a message after it arrives in the user's mailbox.

The retention age for non-recurring items (such as email messages) is calculated differently than items that have an end date or recurring items (such as meetings and tasks). To learn how retention age is calculated for different types of items, see How retention age is calculated.

You can also create retention tags with retention disabled or disable tags after they're created. Because messages that have a disabled tag applied aren't processed, no retention action is taken. As a result, users can use a disabled personal tag as a Never Move tag or a Never Delete tag to override a DPT or RPT that would otherwise apply to the message.

Retention actions

When creating or configuring a retention tag, you can select one of the following retention actions to be taken when an item reaches its retention age:

Retention action Action taken... Except...
Move to Archive1,2 Moves the message to the user's archive mailbox
Only available for DPTs and personal tags
For details about archiving, see In-Place Archiving
If the user doesn't have an archive mailbox, no action is taken.
Delete and Allow Recovery Emulates the behavior when the user empties the Deleted Items folder.
Items are moved to the Recoverable Items folder in Exchange Online in the mailbox and preserved until the deleted item retention period.
Provides the user a second chance to recover the item using the Recover Deleted Items dialog box in Outlook or Outlook on the web
If you've set the deleted item retention period to zero days, items are permanently deleted. For details, see Change how long permanently deleted items are kept for an Exchange Online mailbox.
Permanently Delete Permanently deletes messages.
You can't recover messages after they're permanently deleted.
If mailbox is placed on In-Place Hold and Litigation Hold or Litigation Hold, items are preserved in the Recoverable Items folder based on hold parameters. In-Place eDiscovery will still return these items in search results.
Mark as Past Retention Limit Marks a message as expired. In Outlook 2010 or later, and Outlook on the web, expired items are displayed with the notification stating 'This item has expired' and 'This item will expire in 0 days'. In Outlook 2007, items marked as expired are displayed by using strikethrough text. N. A.

Note

1 In an Exchange hybrid deployment, you can enable a cloud-based archive mailbox for an on-premises primary mailbox. If you assign an archive policy to an on-premises mailbox, items are moved to the cloud-based archive. If an item is moved to the archive mailbox, a copy of it isn't retained in the on-premises mailbox. If the on-premises mailbox is placed on hold, an archive policy will still move items to the cloud-based archive mailbox where they are preserved for the duration specified by the hold.
2 To move Calendar items from Primary to Online Archive mailbox, create a Default Policy Tag and apply it to the mailbox. In Exchange Online, Personal Tags cannot be applied to the Calendar folder in Outlook or OWA.

For details about how to create retention tags, see Create a Retention Policy.

Retention policies

To apply one or more retention tags to a mailbox, you must add them to a retention policy and then apply the policy to mailboxes. A mailbox can't have more than one retention policy. Retention tags can be linked to or unlinked from a retention policy at any time, and the changes automatically take effect for all mailboxes that have the policy applied.

A retention policy can have the following retention tags:

Retention tag type Tags in a policy
Default policy tag (DPT) One DPT with the Move to Archive action
One DPT with the Delete and Allow Recovery or Permanently Delete actions
One DPT for voice mail messages with the Delete and Allow Recovery or Permanently Delete action
Retention policy tags (RPTs) One RPT for each supported default folder
> Note: You can't link more than one RPT for a particular default folder (such as Deleted Items) to the same retention policy.
Personal tags Any number of personal tags
> Tip: **Many personal tags in a policy can confuse users. We recommend adding no more than 10 personal tags to a retention policy.

Note

Although a retention policy doesn't need to have any retention tags linked to it, we don't recommend using this scenario. If mailboxes with retention policies don't have retention tags linked to them, this may cause mailbox items to never expire.

A retention policy can contain both archive tags (tags that move items to the personal archive mailbox) and deletion tags (tags that delete items). A mailbox item can also have both types of tags applied. From a retention perspective, the primary mailbox and online archive should not be looked at as separate entities. Retention settings are applied to the primary mailbox, and by design, extend to the online archive. The online archive is an extension of the primary mailbox.

When planning to create retention policies, you must consider whether they'll include both archive and deletion tags. As mentioned earlier, a retention policy can have one DPT that uses the Move to Archive action and one DPT that uses either the Delete and Allow Recovery or Permanently Delete action. The DPT with the Move to Archive action must have a lower retention age than the DPT with a deletion action. For example, you can use a DPT with the Move to Archive action to move items to the archive mailbox in two years, and a DPT with a deletion action to remove items from the mailbox in seven years. Items in both primary and archive mailboxes will be deleted after seven years.

For a list of management tasks related to retention policies, see Messaging Records Management Procedures.

Default retention policy

Exchange Setup creates the retention policy Default MRM Policy. The Default MRM Policy is applied automatically to new mailboxes in Exchange Online. In Exchange Server, the policy is applied automatically if you create an archive for the new user and don't specify a retention policy

You can modify tags included in the Default MRM Policy, for example by changing the retention age or retention action, disable a tag or modify the policy by adding or removing tags from it. The updated policy is applied to mailboxes the next time they're processed by the Managed Folder Assistant.

For more information, including a list of retention tags linked to the policy, see Default Retention Policy in Exchange Online and Exchange Server.

Managed Folder Assistant

The Managed Folder Assistant, a mailbox assistant that runs on Mailbox servers, processes mailboxes that have a retention policy applied.

The Managed Folder Assistant applies the retention policy by inspecting items in the mailbox and determining whether they're subject to retention. It then stamps items subject to retention with the appropriate retention tags and takes the specified retention action on items past their retention age.

The Managed Folder Assistant is a throttle-based assistant. Throttle-based assistants are always running and don't need to be scheduled. The system resources they can consume are throttled. You can configure the Managed Folder Assistant to process all mailboxes on a Mailbox server within a certain period (known as a work cycle). Additionally, at a specified interval (known as the work cycle checkpoint), the assistant refreshes the list of mailboxes to be processed. During the refresh, the assistant adds newly created or moved mailboxes to the queue. It also reprioritizes existing mailboxes that haven't been processed successfully due to failures and moves them higher in the queue so they can be processed during the same work cycle.

You can also use the Start-ManagedFolderAssistant cmdlet to manually trigger the assistant to process a specified mailbox.

Note

The Managed Folder Assistant doesn't take any action on messages that aren't subject to retention, specified by disabling the retention tag. You can also disable a retention tag to temporarily suspend items with that tag from being processed.

MRM won't move items larger than the values of MaxSendSize and MaxReceiveSize set on the mailbox.

Moving items between folders

A mailbox item moved from one folder to another inherits any tags applied to the folder to which it's moved. If an item is moved to a folder that doesn't have a tag assigned, the DPT is applied to it. If the item has a tag explicitly assigned to it, the tag always takes precedence over any folder-level tags or the default tag.

Applying a retention tag to a folder in the archive

When a user applies a personal tag to a folder in the archive mailbox, if a folder with the same name exists in the primary mailbox and has a different tag, the tag on that folder in the archive mailbox will be reset to match the one in the primary mailbox as soon as the Managed Folder Assistant (MFA) processes the mailbox. This is by design to avoid any confusion about items in a folder in the archive mailbox having a different expiry behavior than the same folder in the user's primary mailbox.

Example: A user has a folder named Project Contoso in the primary mailbox with a Delete - three years personal tag and a Project Contoso folder also exists in the archive mailbox. The user applies a Delete - one year personal tag to delete items in the Project Contoso folder in archive mailbox. The next time the mailbox is processed by MFA, the folder reverts back to the Delete - three years personal tag, based on the applied tag in primary mailbox. This behavior occurs for any folder for which a folder with an identical folder path exists in the primary mailbox. It doesn't matter if it is a user created folder or a default folder (e.g., Inbox or Deleted Items).

Removing or deleting a retention tag from a retention policy

When a retention tag is removed from the retention policy applied to a mailbox, the tag is no longer available to the user and can't be applied to items in the mailbox.

Existing items that have been stamped with that tag continue to be processed by the Managed Folder Assistant based on those settings and any retention action specified in the tag is applied to those messages.

However, if you delete the tag, the tag definition stored in Active Directory is removed. This causes the Managed Folder Assistant to process all items in a mailbox and restamp the ones that have the removed tag applied. Depending on the number of mailboxes and messages, this process may significantly consume resources on all Mailbox servers that contain mailboxes with retention policies that include the removed tag.

Important

If a retention tag is removed from a retention policy, any existing mailbox items with the tag applied will continue to expire based on the tag's settings. To prevent the tag's settings from being applied to any items, you should delete the tag. Deleting a tag removes it from any retention policies in which it's included.

Disabling a retention tag

If you disable a retention tag, the Managed Folder Assistant ignores items that have that tag applied. Items that have a retention tag for which retention is disabled are either never moved or never deleted, depending on the specified retention action. Because these items are still considered tagged items, the DPT doesn't apply to them. For example, if you want to troubleshoot retention tag settings, you can temporarily disable a retention tag to stop the Managed Folder Assistant from processing messages with that tag.

Note

The retention period for a disabled retention tag is displayed to the user as Never. If a user tags an item believing it will never be deleted, enabling the tag later may result in unintentional deletion of items the user didn't want to delete. The same is true for tags with the Move to Archive action.

Retention hold

When users are temporarily away from work and don't have access to their e-mail, retention settings can be applied to new messages before they return to work or access their e-mail. Depending on the retention policy, messages may be deleted or moved to the user's personal archive. You can temporarily suspend retention policies from processing a mailbox for a specified period by placing the mailbox on retention hold. When you place a mailbox on retention hold, you can also specify a retention comment that informs the mailbox user (or another user authorized to access the mailbox) about the retention hold, including when the hold is scheduled to begin and end. Retention comments are displayed in supported Outlook clients. You can also localize the retention hold comment in the user's preferred language.

Note

Placing a mailbox on retention hold doesn't affect how mailbox storage quotas are processed. Depending on the mailbox usage and applicable mailbox quotas, consider temporarily increasing the mailbox storage quota for users when they're on vacation or don't have access to e-mail for an extended period. For more information about mailbox storage quotas, see Mailbox storage limits.

During long absences from work, users may accrue a large amount of e-mail. Depending on the volume of e-mail and the length of absence, it may take these users several weeks to sort through their messages. In these cases, consider the additional time it may take the users to catch up on their mail before removing them from retention hold.

If your organization has never implemented MRM, and your users aren't familiar with its features, you can also use retention holds during the initial warm up and training phase of your MRM deployment. You can create and deploy retention policies and educate users about the policies without the risk of having items moved or deleted before users can tag them. A few days before the warm up and training period ends, you should remind users of the warm-up deadline. After the deadline, you can remove the retention hold from user mailboxes, allowing the Managed Folder Assistant to process mailbox items and take the specified retention action.

For details about how to place a mailbox on retention hold, see Place a mailbox on retention hold.

Run diagnostics to check retention policy settings

Note

This feature requires a Microsoft 365 administrator account. This feature isn't available for Microsoft 365 Government, Microsoft 365 operated by 21Vianet, or Microsoft 365 Germany.

You can run an automated diagnostic check on a user's mailbox to check and validate the retention policy settings configured for the user.

To run the diagnostic check, click the button below.

A flyout page opens in the Microsoft 365 admin center. Enter the email address of the mailbox you want to check and click Run Tests.

Run diagnostics on retention policy settings.