Storing Zoom Chat message history

Account owners or admins can choose how long chat messages are stored in the Zoom Cloud and on local devices. All messages older than the designated retention periods are deleted. Using Zoom Cloud storage also allows account owners and admins to view, download, or delete stored chat messages (within their chosen cloud storage retention period) through the Chat History Report.

Account owners and admins can set these retention periods for all users on the account, as well as different retention periods for user groups. For group chats and channels that include members from different groups or accounts with different cloud storage retention periods, all group chats and channels will follow the cloud storage retention period of the owner for that group chat or channel. 1:1 chats will continue to use the shortest retention period between the users. Local storage retention, on the other hand, follows each user's specific settings, independent of other group members' settings.

Requirements for managing chat storage retention

Table of Contents

Understanding cloud and local storage

Zoom Cloud Storage

Enabling the Store messages in Zoom’s cloud setting means that messages and files will be stored in Zoom’s cloud storage, allowing them to be viewed, downloaded, or deleted by account owner or admins in the Chat History report at any time within their chosen cloud storage retention period. If disabled, messages and files are not stored in Zoom’s cloud, but messages sent to offline users can be received for up to 7 days (depending on the local storage setting).

By default, the cloud storage retention period for messages is 2 years, but account owners and admins of paid accounts* can change this length of time to as short as 1 day or up to 10 years. Retention period for messages stored in the cloud can be set either at the account level (applicable to all users on the account) or at a user group level (applicable to all users in the user group).

*Note: For free accounts, cloud storage retention is set to 2 years and cannot be changed.

The retention period of a message is determined and set at the time it is sent, and is calculated based on a number of factors, including the users involved in the conversation and whether it is sent as part of a direct conversation (1:1 chats) or as part of a group conversation (group chats and channels).

The table below provides examples of various scenarios and how the retention period is calculated. Generally, there are 2 high-level scenarios:

Notes:

Local storage

Enabling the Set retention period for messages on local devices controls how long messages are stored on local devices, and are thereby visible to end users in the Zoom app. If this setting is disabled, messages are never deleted locally while the app is installed on the device.

By default, this setting is disabled, meaning messages are never deleted. Account owners and admins of paid accounts* can change this length of time to as short as 1 day or up to 10 years. Retention periods can be set for all users on the account, as well as different retention periods for user groups.

*Note: For free accounts, the control for setting local storage retention is disabled and cannot be changed for free accounts. These messages are stored locally for up to a year on the local device, except when the Zoom app is deleted. 

Local storage retention operates differently that Cloud storage retention, as each user's local storage follows their specific Local Storage settings, regardless of other group members' settings. For example, if a user belongs to a channel with members who have different local storage policies, their local storage will still follow their own setting. If a user belongs to two different groups with different local storage settings, the most restrictive policy applies. A member not in any group follows the account's default local retention policy, while another member in a custom group follows that group's local retention policy, leading to different retention periods for each member.

When the local storage retention period is changed, the new setting applies to both existing and new messages on the device. Learn more about how local storage retention changes are enforced across apps.

Notes:

How local storage retention changes are enforced across apps

When an admin changes the local storage retention period (for example, reducing it from 1 year to 30 days), the updated policy is enforced as follows:

Zoom Web App

Changes to the cloud storage retention period take effect immediately for the Web App. The updated retention applies only to new messages going forward. Messages sent before the change will still be available, even if they are older than the new retention period. No user action (such as signing out and signing back in) is required.

Desktop app (versions prior to 7.0.5)

Once the local storage retention setting is changed in the Zoom web portal, the updated setting is synchronized from the Zoom backend to the desktop app within approximately 12 hours. No user sign-out or sign-in is required for the policy to take effect.

When the updated retention setting is received by the app:

Desktop app (version 7.0.5 and higher)

For the desktop app version 7.0.5 and later, there is currently no automatic synchronization of local storage retention settings from the backend to the desktop app. Users must sign out and sign back in for the updated retention policy to take effect on the local device.

Note: An enhancement to enable automatic synchronization for the new Chat experience is planned. This article will be updated when the enhancement becomes available.

Mobile app

The mobile app follows the same enforcement behavior as the desktop app version in use. If the user is on a version prior to 7.0.5, the retention setting synchronizes automatically within approximately 12 hours. If the user is on version 7.0.5 or later (New Chat), a sign-out and sign-in is required.

AppsAuto-sync of retention changes?User action required?Approximate enforcement delay
Zoom Web AppYesNoneUpon next sign-in
Desktop app (versions prior to 7.0.5)YesNoneUp to 12 hours
Desktop app (version 7.0.5 and higher)NoSign out and sign back inUpon next sign-in
Mobile app (versions prior to 7.0.5)YesNoneUp to 12 hours
Mobile app (version 7.0.5 and higher)NoSign out and sign back inUpon next sign-in

Scope of retention settings

The following retention settings apply to different scopes:

Note: 1:1 chat messages and group chat messages have separate local and cloud storage retention settings from channel messages. These settings take effect independently. If an admin configures local retention for 1:1/group chats, channel messages are not affected unless the channel retention setting is also changed.

How local retention changes affect existing and new messages

When the local storage retention period is reduced, the new setting applies to both existing and new messages on the local device. Messages that are older than the newly configured retention period will be deleted from local storage once the policy is enforced (either automatically or after sign-out/sign-in, depending on the app version).

There is no need for a backend purge or manual intervention to remove locally cached messages, the app handles deletion automatically based on the updated erase time received from the server.

Note: To quickly clear local chat history, an admin can temporarily set the local device retention period to 1 day. Once the policy is enforced on users' devices, messages older than 1 day will be removed. The admin can then adjust the retention period to the desired long-term value.

How to change Chat message storage settings

Chat admins can access messaging history in the Zoom web portal by enabling cloud storage for chat and configuring retention policies. You can change settings to specify how long chat messages are stored for.

Account

  1. Sign in to the Zoom web portal as an admin with the privilege to edit account settings.
  2. In the navigation menu, click Account Management then Account Settings.
  3. Click the Chat tab.
  4. Under Storage, click the toggles next to the following settings to enable or disable them. If a verification dialog appears, click Enable or Disable to verify the change.
  5. Click Save, where appropriate.
  6. (Optional) To prevent all users in your account from changing a setting, click the lock icon next to it , and then click Lock to confirm the setting.

Group

  1. Sign in to the Zoom web portal as an admin with the privilege to edit groups.
  2. In the navigation menu, click User Management then Groups.
  3. Click the applicable group name from the list.
  4. Click the Chat tab.
  5. Under Storage, click the toggles next to the following settings to enable or disable them. If a verification dialog appears, click Enable or Disable to verify the change. If the option is grayed out, it has been locked at the account level and needs to be changed at that level.
  6. Click Save, where appropriate.
  7. (Optional) To prevent all users in your account from changing a setting, click the lock icon next to it , and then click Lock to confirm the setting.

Cloud storage retention examples

The following table shows how long chat messages are stored in the cloud for a variety of scenarios, depending on the chat type and involved users.

Chat typeUsers involved and set retention periodsApplied cloud retention period for sent messages
(and reasoning why)
1-on-1 chat
  • 2 free users
    (2 years)
2 years
(Both are free users)
1-on-1 chat
  • 1 free user
    (2 years)
  • 1 paid user with Cloud Storage enabled and a 5-year retention period
2 years
(Comparing the 2-year to the 5-year retention period, 2 years is the shortest between them)
1-on-1 chat
  • 1 free user
    (2 years)
  • 1 paid user with Cloud Storage disabled
Not stored in the cloud
(Comparing the 2-year retention period to no retention period, no retention is the shortest between them)

Note: Even with Cloud Storage disabled, messages sent to offline users will be stored in the cloud for up to 7 days and then auto-deleted.

1-on-1 chat
  • 1 paid user with Cloud Storage enabled and a 4-year retention period
  • 1 paid user with Cloud Storage enabled and a 6-year retention period
4 years

(Comparing the 4-year to the 6-year retention period, 4 years is the shortest between them)

1-on-1 chat
  • 1 paid user with Cloud Storage enabled and a 3-year retention period
  • 1 free user who joins a paid account with Cloud Storage enabled and a 5-year retention period
While a free user, the messages are saved for 2 years (the shortest of the 2)

After joining the paid account, all new messages are saved for 3 years (the shortest of the 2)

Channel or group chat
  • 1 free user as the channel owner
    (2 years)
  • 1 or more paid users with Cloud Storage enabled and a 3-year retention period
2 years
(Based on channel owner’s retention period)
Channel or group chat
  • 1 or more free users
  • 1 paid user (channel owner) with Cloud Storage enabled and a 3-year retention period
3 years
(Based on channel owner’s retention period)
Channel or group chat
  • 1 or more free users
  • 1 or more paid users with Cloud Storage enabled and a 3-year retention period
  • 1 paid user (channel owner) with Cloud Storage disabled
Not stored in the cloud
(Based on channel owner’s retention period)

Note: Even with Cloud Storage disabled, messages sent to offline users will be stored in the cloud for up to 7 days and then auto-deleted.

Channel or group chat
  • 1 paid user (original channel owner) with Cloud Storage enabled and a 3-year retention period
  • 1 free user (new channel owner)
3 years while the paid user is the channel owner.

2 years when the free user becomes channel owner (applies to messages sent after the change)

Note: Group chats and channels that contain users from several accounts can also affect cloud storage retention. Learn more about the effect of Zoom Chat settings on inter-account communications.

Chat History Reporting examples

The following scenarios describe which accounts can view chat messages in the Chat History Report, based on the chat type and involved users.

Note: The account must have the Cloud Storage setting enabled for messages to be available in the Chat History Report.

Chat typeUsers involvedWhich account can view the messages?
1-on-1 chat
  • 2 free users
Not applicable, as all reporting is unavailable for free accounts.
Channel or group chat
  • 1 internal free user
  • 1 external paid user
Paid user's account
Channel or group chat
  • 1 internal free user
  • 1 external free user
  • 1 external paid user
Paid user's account
Channel or group chat
  • 1 internal paid user
  • 2 external free users
Paid user's account
Channel or group chat
  • 1 internal paid user
  • 1 external paid user
Both users' accounts
Channel or group chat
  • 1 internal paid user
  • 1 external free user
  • 1 external paid user
Both paid user's accounts
1-on-1, channel, or group chat
  • 1 internal paid user
  • 1 external free user added to the paid user's account, thus becoming an internal user
Paid user’s account admin can access messages from external free users before and after the free user is added to the paid user’s account