zulip/templates/zerver/help/message-retention-policy.md

73 lines
2.3 KiB
Markdown

# Message retention policy (beta)
{!owner-only.md!}
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:
* Setting an organization-level retention policy, which applies to
all private messages and all streams without a specific policy.
* 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.
In Zulip Cloud, message retention policies are available on the Zulip
Cloud Standard and Zulip Cloud Plus [plans](https://zulip.com/plans),
as well as for the hundreds of communities with sponsored Cloud
Standard hosting.
### 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.
1. On the right, click **[Change]** next to the description of the stream
permissions.
1. Under **Message retention for stream**, configure **Message retention period**.
{!save-changes.md!}
{end_tabs}
## 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
meant to preserve, contact Zulip support promptly for assistance with
restoration. See the [deletion
documentation](/help/edit-or-delete-a-message#how-deletion-works) for
more details on precisely how message deletion works in Zulip.
## Related articles
* [Edit or delete a message](/help/edit-or-delete-a-message)
* [Delete a topic](/help/delete-a-topic)
* [Delete a stream](/help/delete-a-stream)