Automatically apply a retention label to retain or delete content

Microsoft 365 licensing guidance for security & compliance.


This scenario is not supported for regulatory records.

One of the most powerful features of retention labels is the ability to apply them automatically to content that matches specified conditions. In this case, people in your organization don't need to apply the retention labels. Microsoft 365 does the work for them.

Auto-applying retention labels are powerful because:

  • You don't need to train your users on all of your classifications.

  • You don't need to rely on users to classify all content correctly.

  • Users no longer need to know about data governance policies - they can focus on their work.

You can apply retention labels to content automatically when that content contains sensitive information, keywords or searchable properties, or a match for trainable classifiers.


Now in preview, use searchable properties to identify Teams meeting recordings.

The processes to automatically apply a retention label based on these conditions:

Diagram of roles and tasks for auto-apply labels

Use the following instructions for the two admin steps.


Auto-policies use service-side labeling with conditions to automatically apply retention labels. You can also automatically apply a retention label with a label policy when you do the following:

  • Apply a default retention label to a SharePoint library, folder, or document set so that unlabeled content in that container is automatically labeled
  • Automatically applying a retention label to email by using rules

For these scenarios, see Create and apply retention labels in apps.

Before you begin

The global admin for your organization has full permissions to create and edit retention labels and their policies. If you aren't signing in as a global admin, see Permissions required to create and manage retention policies and retention labels.

How to auto-apply a retention label

First, create your retention label. Then create an auto-policy to apply that label. If you have already created your retention label, skip to creating an auto-policy.

Navigation instructions depend on whether you're using records management or not. Instructions are provided for both scenarios.

Step 1: Create a retention label

  1. In the Microsoft 365 compliance center, navigate to one of the following locations:

    • If you are using records management:

      • Solutions > Records management > File plan tab > + Create a label > Retention label
    • If you are not using records management:

      • Solutions > Information governance > Labels tab > + Create a label

    Don't immediately see your option? First select Show all.

  2. Follow the prompts in the wizard. If you are using records management:

  3. After you have created the label and you see the options to publish the label, auto-apply the label, or just save the label: Select Auto-apply this label to a specific type of content, and then select Done to start the Create auto-labeling wizard that takes you directly to step 2 in the following procedure.

To edit an existing label, select it, and then select the Edit label option to start the Edit retention wizard that lets you change the label descriptions and any eligible settings from step 2.

Step 2: Create an auto-apply policy

When you create an auto-apply policy, you select a retention label to automatically apply to content, based on the conditions that you specify.

  1. In the Microsoft 365 compliance center, navigate to one of the following locations:

    • If you are using records management: Information governance:

      • Solutions > Records management > Label policies tab > Auto-apply a label
    • If you are not using records management:

      • Solutions > Information governance > Label policies tab > Auto-apply a label

    Don't immediately see your option? First select Show all.

  2. Follow the prompts in the Create auto-labeling wizard.

    For information about configuring the conditions that automatically apply the retention label, see the Configuring conditions for auto-apply retention labels section on this page.

    For information about the locations supported by retention labels, see the Retention labels and locations section.

To edit an existing auto-apply policy, select it to start the Edit retention policy wizard that lets you change the selected retention label and any eligible settings from step 2.

Configuring conditions for auto-apply retention labels

You can apply retention labels to content automatically when that content contains:

Auto-apply labels to content with specific types of sensitive information

When you create auto-apply retention labels for sensitive information, you see the same list of policy templates as when you create a data loss prevention (DLP) policy. Each template is preconfigured to look for specific types of sensitive information. For example, the template shown here looks for U.S. ITIN, SSN, and passport numbers from the Privacy category, and U.S Personally Identifiable Information (PII) Data template:

Policy templates with sensitive information types

To learn more about the sensitivity information types, see Sensitive information type entity definitions.

After you select a policy template, you can add or remove any types of sensitive information, and you can change the instance count and match accuracy. In the example screenshot shown next, a retention label will be auto-applied only when:

  • The type of sensitive information that's detected has a match accuracy (or confidence level) of at least 75. Many sensitive information types are defined with multiple patterns, where a pattern with a higher match accuracy requires more evidence to be found (such as keywords, dates, or addresses), while a pattern with a lower match accuracy requires less evidence. The lower the min match accuracy, the easier it is for content to match the condition.

  • The content contains between 1 and 9 instances of any of these three sensitive information types. You can delete the to value so that it changes to Any.

For more information about these options, see the following guidance from the DLP documentation Tuning rules to make them easier or harder to match.

Options for identifying sensitive information types

Auto-apply labels to content with keywords or searchable properties

You can auto-apply labels to content by using a query that contains specific words, phrases, or values of searchable properties. You can refine your query by using search operators such as AND, OR, and NOT.

Query editor

For more information about the query syntax that uses Keyword Query Language (KQL), see Keyword Query Language (KQL) syntax reference.

Query-based labels use the search index to identify content. For more information about the searchable properties that you can use, see:


Although SharePoint managed properties support aliases, don't use these when you configure your retention labels. Always specify the actual name of the managed property, for example, "RefinableString01".

Examples queries:

Workload Example
Exchange subject:"Quarterly Financials"
SharePoint contenttype:contract
SharePoint site: AND contenttype:contract
Microsoft Teams meeting recordings


The ability to retain and delete Teams meeting recordings is rolling out in preview and won't work before recordings are saved to OneDrive or SharePoint. For more information, see Use OneDrive for Business and SharePoint Online or Stream for meeting recordings.

To identify Microsoft Teams meeting recordings that are stored in users' OneDrive accounts or in SharePoint, specify the following for the Keyword query editor:

ProgID:Media AND ProgID:Meeting

For this retention label, you must also publish it to the relevant users' OneDrive accounts or SharePoint sites by creating a label policy. Most of the time, the meeting recordings are saved to OneDrive, but for channel meetings, they are saved in SharePoint.

When you have saved the auto-apply policy:

  1. Select Label policies tab > Publish labels

  2. When prompted to select a label, choose the label you created with the KQL query to identify Teams meeting recordings.

  3. When prompted for the location, choose SharePoint sites and OneDrive accounts. You can then keep the default of All, or specify individual locations, such as including or excluding specific OneDrive accounts.

  4. Complete the wizard and save this label policy.

Auto-apply labels to content by using trainable classifiers

When you choose the option for a trainable classifier, you can select one of the built-in classifiers, or a custom classifier. The built-in classifiers include Resumes, SourceCode, Targeted Harassment, Profanity, and Threat:

Choose trainable classifier


We are deprecating the Offensive Language built-in classifier because it has been producing a high number of false positives. Don't use this built-in classifier and if you are currently using it, you should move your business processes off it. We recommend using the Targeted Harassment, Profanity, and Threat built-in classifiers instead.

To automatically apply a label by using this option, SharePoint sites and mailboxes must have at least 10 MB of data.

For more information about trainable classifiers, see Learn about trainable classifiers (preview).


If you use trainable classifiers for Exchange, see the recently released How to retrain a classifier in content explorer (preview).

How long it takes for retention labels to take effect

When you auto-apply retention labels, it can take up to seven days for the retention labels to be applied to all existing content that matches the conditions.

Diagram of when auto-apply labels take effect

If the expected labels don't appear after seven days, check the Status of the auto-apply policy by selecting it from the Label policies page in the compliance center. If you see the status of Off (Error) and in the details for the locations see a message that it's taking longer than expected to deploy the policy (for SharePoint) or to try redeploying the policy (for OneDrive), try running the Set-RetentionCompliancePolicy PowerShell command to retry the policy distribution:

  1. Connect to Security & Compliance Center PowerShell

  2. Run the following command:

    Set-RetentionCompliancePolicy -Identity <policy name> -RetryDistribution

Updating retention labels and their policies

When you edit a retention label or auto-apply policy, and the retention label is already applied to content, your updated settings will automatically be applied to this content in addition to content that's newly identified.

Some settings can't be changed after the label or policy is created and saved, which include:

  • The retention settings except the retention period, unless you've configured the label to retain or delete the content based on when it was created.
  • The option to mark items as a record.

Next steps

See Use retention labels to manage the lifecycle of documents stored in SharePoint for an example scenario that uses an auto-apply policy with managed properties in SharePoint, and event-based retention to start the retention period.