Place Gmail messages on hold

As part of your Google Workspace data eDiscovery projects, you can use holds to preserve Gmail messages indefinitely to meet legal or preservation obligations. You can apply a hold to individual accounts or all accounts in an organizational unit. Holds override retention rules, so data on hold is protected from your normal data governance rules that might purge it otherwise.

Important information about Gmail holds

Before you set holds, we recommend you read Get started with holds in Google Vault and review the Gmail messages supported in Vault.

Expand all  |  Collapse all

Place a hold on Gmail messages

1. Sign in to https://vault.google.com.
2. Click Matters.
3. If the matter already exists, click it to open it. Otherwise, create a matter:
   1. Click Create.
   2. Enter a name for the matter and, optionally, a description.
   3. Click Create.
4. Click HoldsCreate.
5. Enter a unique name for the hold.
6. Click Choose serviceGmail.
7. Click Continue.
8. Select the scope of the hold:
   • Specific accounts—Enter one or more account or group email addresses.
   • Organizational unit—Select an organizational unit.

     Note: We strongly recommend that you don’t select the top organizational unit. You won’t be able to delete any Google Workspace accounts from your organization. Learn more

9. Click Continue.
10. (Optional) Set the conditions for the hold:
    • Sent date—Enter dates to limit the hold to messages sent within the start and end dates.
      • To hold messages sent on or after a specific date, enter only a start date.
      • To hold message sent on or before a specific date, enter only an end date.
      • To hold messages no matter when they were sent, don't enter a start or end date.
    • Terms—Enter search terms and operators to apply the hold to only messages that match the terms.

      Note:

      • When a user account is in the scope of the hold, the account can't be deleted until the hold is removed, even when none of their messages match the terms. If you set a hold on the top organizational unit and refine it with terms, you won't be able to delete any users.
      • You can't use is:chat to apply a Gmail hold to chat messages in Google Chat. To hold chat messages, set a Chat hold.
11. Click Create.

Edit a hold on Gmail messages

You can change some hold parameters, but you can't change the service (Gmail to another service) or the scope type (such as accounts to an organizational unit).

1. Sign in to https://vault.google.com.
2. Click Matters and then the matter that contains the hold.
3. To change the accounts or organizational units that are covered by the hold:
   1. Click Scope.
   2. Add or remove accounts or change the organizational unit.

      Note: You can't add accounts to a hold that covers an organizational unit, and you can't add organizational units to a hold that covers specific accounts.

      If you remove all accounts, you're prompted to delete the hold.

   3. Click Continue.
4. To change the sent date range or terms, click Conditions.
   • Sent date—Expand or restrict the range of dates subject to hold.
   • Terms—Add or remove search terms and operators to change which messages are subject to the hold.
5. Click Save.