Skip to content
πŸ—‚οΈ Category Setup

πŸ—‚οΈ Autodelete a whole Category

Category Setup lets one configuration govern every channel inside a category β€” optionally including their threads and forum posts. Instead of maintaining dozens of channel configs, you manage a single shared one.

✨ Premium: Category configs are currently a Premium feature while this rollout is being scaled up carefully.


Creating a category config

  1. Run /category-setup anywhere in your server and pick the category from the list
    • You do not need to be inside the category β€” the picker lists all categories of the server
  2. The bot first shows you how many channels the category contains, so you can confirm you picked the right one
  3. Click “Create Config” and configure it like a normal channel config (modes, limit, filters, roles…)
  4. As always, changes become active about one minute after your last edit

Everything in a single category config then applies to the category’s channels, both existing ones and channels added later.


What gets covered and when

TargetCovered by default?How to enable
Text/announcement/voice channels in the categoryβœ… Yesautomatic
Channels created after the config existsβœ… Yesautomatic
Channels moved into the categoryβœ… Yesautomatic (incl. loading their existing messages if you chose so)
Channels moved out of the categoryβœ… Stops automaticallyβ€”
Threads inside those channels❌ Noenable Include Threads in the category menu
Posts of a forum inside the category❌ Noenable Include Threads in the category menu (posts are threads)

Include Threads on a category

On a category, Include Threads means: “the category’s config also governs all threads/posts inside the category’s channels” (a category has no threads of its own). Enabling it follows the same rules as on channels - Premium is required to turn it on, never to turn it off.

You’ll be offered a backfill prompt to also catch up existing threads’ messages; the bot additionally searches all channels of the category via the Discord API (including archived thread listings, where your permissions allow).


Combine with channel configs

A channel inside a managed category can still have its own channel config(s) (/setup inside the channel). In that case both apply at once β€” the category config and the channel config. Running /setup in such a channel shows a hint if it is governed by a category config.

This makes category configs perfect as a baseline (“delete everything after 24h”) plus channel exceptions ("…but keep #announcements for a week").

About the /setup vs /category-setup distinction

  • /category-setup myCategory manages the shared category config
  • /setup inside a channel manages that channel’s own configs
  • /list shows all configs of the server

If a channel shows “no configs” in /setup but /list shows one, check the banner: it’s probably governed by its category.


Deleting old messages

When creating or editing a category config, choose “Yes” on the “delete old messages” prompt and the bot will backfill every channel of the category (plus their threads if Include Threads is on) β€” not just new messages going forward.

ℹ️ Info: As with all configs, Discord only lets bots delete messages that are at most 14 days old.


Stopping / deleting

Deleting the config in /category-setup stops everything it governed (all channels, and their threads when included) immediately.

/stop inside an individual channel only affects that channel’s own configs β€” it does not disable the shared category config.


Notices

/autodelete-notice inside a channel also shows inherited rules β€” configs coming from its category (or parent channel) are marked with their origin, so members understand why messages vanish.


Permissions & Limits

  • The bot needs Manage Threads to cover the categories’ threads (asked for when enabling Include Threads)
  • A category config counts as one config against your limit
  • Existing channels keep working independently; per-channel configs stack additively (they don’t get replaced)

Common issues

“It deletes in one channel but not the other” β†’ Give it a moment after saving (one-minute activation buffer). Channels created just before saving are normally picked up automatically; if one wasn’t, re-saving the config re-applies it.

“Forum posts aren’t deleted” β†’ Enable Include Threads on the category config (post coverage lives there, and requires Premium).

“The toggle says Threads is Premium” β†’ Thread/post cascade needs Premium on this bot. The base category cascade (the channels themselves) is also Premium-gated during rollout.

See also: Include Threads Β· Forum Setup Β· Troubleshooting

Last updated on