Use Vault to search Google Chat

To search your Google Chat messages in Chat, go here instead.

You can use Vault to search Google Chat messages. 

Vault is for administrators and legal personnel. Vault won't work properly until your G Suite administratorsets up your account. 

Things to know before you search

For even more information, review the Vault Search FAQ.

Files shared with Chat users may be stored in Drive

When someone uses Google Chat to share Google Docs, Sheets, Slides, or Forms, Chat inserts a link rather than attaching a copy of the file to the message. Because the original file is stored in Drive, it isn't included when you retain, hold, search, or export chat messages.

For non-Google files that are directly attached to a chat message, Vault indexes most text-based file types (for example, files with .pdf, .xslx, and .docx extensions). These attachments are included when you search and export chat messages, and they are covered by chat retention rules and holds.

Vault can preview a maximum of 1000 messages per conversation

While Vault can export as many messages as your search will yield, previews are limited to 1000 messages. If you want to preview a large number of messages, use search terms and other criteria to reduce the results to smaller groups of messages.

Vault retrieves a conversation only if a searched participant sends at least one message
Vault returns only DMs and conversations where a participant has sent at least one message. Conversations where a participant may have viewed messages but didn't respond aren't included in search results.
Held data searches don't include rooms unless a user on hold sends a message
When you search held data in a matter, Vault returns a conversation from a room only if a user on hold sent at least one message.
Only conversations in rooms and DMs sent with history on are searchable

Conversations in rooms are always searchable in Vault. However, Vault can search only DMs that were sent with history tuned on. A G Suite admin can control whether history is on or off, or they can allow users to decide.


Search for messages in Chat

  1. Create a matter or click an existing matter.
  2. Click Search in the left pane.
  3. Select Chat as the type of data to search.
  4. Choose a Source:
    • All data—Search all messages in your organization.
    • Held data—Search all messages on hold for the matter.
    • Unprocessed data—Search content that we have identified as partially processed.
  5. Select a search method:
    • Specific accounts—Enter accounts to search. 
    • Organizational Unit—Search within a specific organizational unit. If you choose one with suborganizational units, Vault searches the suborganizational units.
    • Rooms—Search within one or more rooms. 
  6. (Optional) If you select Specific accounts or Organizational Unit, you can check the box to include results from rooms​. Vault searches a room only if a user who is included in the search is a member of the room.
  7. If you select Rooms, click Find Rooms. To select a room:
    1. In the dialog, enter a room member and click Next.
    2. Enter a room and click the room to select it. Repeat to add more rooms.
    3. After you add all the rooms you want to search, click Done.
  8. (Optional) Enter a sent date range:
    Note: If you enter dates, Vault returns all conversations that have messages within that date range and match your query terms. Results may also include messages that match query terms but occur outside of your date range.
    • If you enter a start date, Vault returns all messages sent on or after the date you entered.
    • If you enter an end date, Vault returns all messages sent on or before the date you entered.
  9. (Optional) Choose a time zone, and Vault restricts the search to the time zone you select. However, search results are displayed and exported in GMT. 
  10. (Optional) Use Terms to specify one or more search terms. Use search operators for complex searches.
  11. Click one of the following:
    • Search—to perform a search.
    • Export—to skip preview and immediately export the search results.
  12. (Optional) Click the Search down arrow to:
    1. Reset—to clear the search form.
    2. Duplicate search form—to open another search form under the current form, prepopulated with the information you've already entered.

Preview Chat search results

Search preview includes the following:

  • Snippet—a brief synopsis of the conversation.
  • Owner—participants in an exchange of DMs or the room in which a conversation took place. 
  • Last sent—the date of the last message. If a user edits a message, it can change the last sent date. However, deleting messages has no effect on this date.

When you open a message, the entire conversation is displayed. Only the most recent 1000 messages are included in the preview in very long conversations. You can't preview earlier messages from the thread. However, all messages that match your search criteria are included when you export.

Note: Vault exports only the messages that match your search terms. Go back and modify your search terms if you need to export other messages from Chat.

Export Chat messages

When your search returns the results you need, you can: 

  1. Export the search results.
  2. Analyze the exported files.
Was this helpful?
How can we improve it?