Chat retention and archives
Team chat messages and their files are kept for a period you choose. A retention job deletes older ones. Deleted messages and files cannot be restored.
Where
Admin > Settings > Storage > Chat retention (/admin/chat-retention). Needs settings:read to see and settings:write to change. You do not need a chat seat: you can set the period and hold a room without reading any message.
Company policy
- Open Admin > Settings > Storage > Chat retention.
- Enter Keep messages for (days), from 1 to 3650. If you set nothing, 365 days (one year) applies.
- Optionally set Shortest period a chat may have and Longest period a chat may have (in days). Leave a field empty for no limit. The company period must lie between them. This is how you allow anything from "delete after 30 days" to "keep 10 years".
- Tick Group owners and admins may set their chat's period to let the owners and admins of a group choose their chat's period themselves, within these limits.
- Save. A new period applies at the next run of the retention job. Chats that have their own period outside the limits are brought inside them by the job.
What people see in a chat
Every member sees how the open chat keeps its messages, under the chat header: for example "Messages here are deleted 90 days after they are sent (company policy)". The text says whether the period comes from the company, the default or the chat itself.
When the period of a chat changes, everyone in the chat sees a notice in their own language.
When you allow it, a group's owners and admins choose Change, then pick the company period, a number of days or a number of years. The form shows the limits that apply.
While a chat is under legal hold, it shows Legal hold instead: nothing in the chat is deleted while the hold lasts.
Archive before delete
Switch on Archive messages before the retention job deletes them. The job then writes the messages it is about to delete to an archive file first, and deletes nothing if the archive cannot be written.
Archive files lists them, newest first, with the time written and the size. Download gives one JSON object per line. An archive contains people's messages, so downloading it needs settings:write.
Legal holds
A legal hold keeps everything. While a hold applies, nothing is deleted: not by the retention job, not by "delete for everyone" (administrators included), not when the last member leaves a chat, and not by a personal data erase request. Members can still hide messages for themselves.
Legal holds lists every chat and every person on hold, with the reason, the case reference and since when.
To place a hold:
- Under Place a legal hold, choose Chat and enter the chat id, or choose Person and find them by email.
- Enter the Reason (required, up to 500 characters) and, if you have one, the Case reference (up to 100 characters).
- Choose Place legal hold.
A hold on a person keeps every chat they are in and every message they sent. To end a hold, choose Release on its row. Placing and releasing a hold are recorded in the audit log.
One chat: own period and export
Chats are visible to their members only, so you name the chat by its id.
- Under One chat: own period and export, enter the chat id and choose Load room.
- Set Days to keep this room's messages to give the chat its own period; leave it empty to use the company's period. The period must lie within the company's limits. Save.
- The section shows whether the chat is under legal hold. Place or release the hold under Legal holds.
- To export the chat, choose Export as PDF, Export as JSON or Export as ZIP (with files). The ZIP holds the PDF, the JSON and the attachment files (up to 256 MiB of files; larger exports list the rest without their content). An export holds at most 50 000 messages. The PDF is in your language. Exports need
settings:writeand are recorded in the audit log.
In the chat itself
A company administrator who is a member of a chat can do the same from the chat: choose Retention, hold and export under the chat header. There you set the chat's own period, place or release its legal hold (with a reason and a case reference) and export it.
Working with the lists
The legal hold and archive lists work like the Users list: the ... menu at the end of a row (Release on a hold, Download on an archive). Below 640 pixels wide the table turns into cards with no sideways scrolling. A list that cannot be loaded shows the reason and Try again.