2021-03-25 20:12:50 +01:00
|
|
|
# Message retention policy
|
2020-05-04 08:38:54 +02:00
|
|
|
|
2020-06-11 21:16:53 +02:00
|
|
|
{!owner-only.md!}
|
|
|
|
|
2020-05-04 08:38:54 +02:00
|
|
|
By default, Zulip stores messages indefinitely, allowing full-text
|
|
|
|
search of your complete history.
|
|
|
|
|
|
|
|
Zulip supports configuring both a global organization-level message
|
|
|
|
retention policy, as well as retention policies for individual
|
|
|
|
streams. These policies control how many days a message is stored
|
|
|
|
before being automatically deleted (the default being forever).
|
|
|
|
Zulip's system supports:
|
|
|
|
|
2020-06-19 02:17:07 +02:00
|
|
|
* Setting an organization-level retention policy, which applies to
|
2023-02-10 08:04:36 +01:00
|
|
|
all direct messages and all streams without a specific policy.
|
2020-06-19 02:17:07 +02:00
|
|
|
* Setting a retention policy for individual streams, which overrides
|
|
|
|
the organization-level policy for that stream. This can be used to
|
|
|
|
just delete messages on specific streams, to only retain messages
|
|
|
|
forever on specific streams, or just to have a different retention
|
|
|
|
period.
|
2020-05-04 08:38:54 +02:00
|
|
|
|
|
|
|
In Zulip Cloud, message retention policies are available on the Zulip
|
2023-03-23 03:53:14 +01:00
|
|
|
Cloud Standard and Zulip Cloud Plus [plans](https://zulip.com/plans/),
|
2020-05-04 08:38:54 +02:00
|
|
|
as well as for the hundreds of communities with sponsored Cloud
|
2020-06-19 02:17:07 +02:00
|
|
|
Standard hosting.
|
2020-05-04 08:38:54 +02:00
|
|
|
|
2020-07-06 21:28:35 +02:00
|
|
|
### Configure message retention policy for organization
|
|
|
|
|
|
|
|
{start_tabs}
|
|
|
|
|
|
|
|
{settings_tab|organization-settings}
|
|
|
|
|
|
|
|
4. Under **Message retention**, configure **Message retention period**.
|
|
|
|
|
|
|
|
{!save-changes.md!}
|
|
|
|
|
|
|
|
{end_tabs}
|
|
|
|
|
|
|
|
### Configure message retention policy for individual streams
|
|
|
|
|
|
|
|
{start_tabs}
|
|
|
|
|
|
|
|
{relative|stream|all}
|
|
|
|
|
|
|
|
1. Select a stream.
|
|
|
|
|
2024-04-30 21:57:47 +02:00
|
|
|
{!select-channel-view-general.md!}
|
2020-07-06 21:28:35 +02:00
|
|
|
|
2022-12-06 09:24:04 +01:00
|
|
|
1. Under **Stream permissions**, configure the
|
2022-03-21 13:13:51 +01:00
|
|
|
**Message retention period**.
|
2020-07-06 21:28:35 +02:00
|
|
|
|
|
|
|
{!save-changes.md!}
|
|
|
|
|
|
|
|
{end_tabs}
|
|
|
|
|
2022-07-28 15:38:32 +02:00
|
|
|
{!automated-notice-stream-event.md!}
|
2022-03-24 21:18:31 +01:00
|
|
|
|
2020-05-04 08:38:54 +02:00
|
|
|
## Important details
|
|
|
|
|
|
|
|
* Retention policies are processed in a daily job; so changes in the
|
|
|
|
policy won't have any effect until the next time the daily job runs.
|
|
|
|
|
|
|
|
* Deleted messages are preserved temporarily in a special archive. So
|
|
|
|
if you discover a misconfiguration accidentally deleted content you
|
2020-05-06 15:00:16 +02:00
|
|
|
meant to preserve, contact Zulip support promptly for assistance with
|
2020-05-04 08:38:54 +02:00
|
|
|
restoration. See the [deletion
|
2023-07-19 01:39:18 +02:00
|
|
|
documentation](/help/delete-a-message#delete-a-message-completely) for
|
2020-05-04 08:38:54 +02:00
|
|
|
more details on precisely how message deletion works in Zulip.
|
|
|
|
|
|
|
|
## Related articles
|
|
|
|
|
2023-07-19 01:39:18 +02:00
|
|
|
* [Edit a message](/help/edit-a-message)
|
|
|
|
* [Delete a message](/help/delete-a-message)
|
2020-05-04 08:38:54 +02:00
|
|
|
* [Delete a topic](/help/delete-a-topic)
|
2021-03-31 16:15:24 +02:00
|
|
|
* [Archive a stream](/help/archive-a-stream)
|