Skip to main content

Chat Auto-cleanup / Retention

Automatically deletes "chat messages" older than X days every 6 hours (default 30 days, configurable 1–365). But viewer counters like message count and total donated are kept forever — those don't get deleted.

What it does​

  • Deletes chat messages older than X days every 6 hours
  • Adjustable retention period 1–365 days (default 30)
  • Per-viewer counters (message count, total donated) are kept forever
  • Can be turned on / off

Where to find it​

Settings → Backup → Chat Retention section

Settings → Backup → Chat Retention page showing toggle and 1–365 days slider
Chat retention settings

Inputs / configurable settings​

  • chatAutoCleanupEnabled — on / off toggle
  • chatRetentionDays — 1–365 days

Use case​

A streamer who goes live daily and doesn't want chat building up for months in their DB — set retention to 14 days. Recent chat history is still there for context, and "top chatters" stats stay accurate because the counters aren't deleted.