Skip to main content

Overview

The archive system lets you retire a channel without losing its history. When a channel is archived, it gets renamed, hidden from everyone, and optionally moved to a dedicated archive category — while a fresh replacement channel is created in its original spot with the same name and permissions.
Archive records are saved automatically, so any archived channel can be fully restored later with archive remove.

Commands

Archive a channel by hiding it and creating a fresh replacement in its place.
~archive [#channel]
Parameters:
  • channel (optional) — Channel mention or ID. Defaults to the current channel if not specified.
What It Does:
  • Prompts for confirmation before proceeding
  • Creates a new channel in the same position with the same name, topic, and permissions
  • Renames the original to archived-{name} and hides it from everyone
  • Moves it to the archive category (if one is set)
  • Transfers any Welcome, Goodbye, or JoinPing settings to the new channel
Aliases: arch
Permissions: Administrator
Cooldown: 30 seconds
Undo an archive — restore the original channel and delete the replacement.
~archive remove <#channel>
Parameters:
  • channel — The replacement channel created during archiving (mention or ID)
What It Does:
  • Restores the original channel’s name, position, category, and permissions
  • Transfers Welcome, Goodbye, and JoinPing settings back to the restored channel
  • Deletes the replacement channel
The original archived channel must still exist in the server for a restore to work. If it was manually deleted, restoration is not possible.
Aliases: arch
Permissions: Administrator
Set a category where archived channels get moved to.
~archive category <categoryId>
Parameters:
  • categoryId — The ID of a category channel
What It Does:
  • Archived channels are automatically moved into this category
  • Channels remain hidden from everyone regardless of the category’s settings
  • Run ~archive category with no arguments to view the currently set category
Aliases: arch
Permissions: Administrator
Remove the configured archive category.
~archive category clear
What It Does:
  • Clears the archive category setting
  • Future archived channels will stay in their original category instead of being moved
Aliases: arch
Permissions: Administrator

How It Works

1

(Optional) Set an Archive Category

Point archived channels to a dedicated category so they stay organized:
~archive category 1234567890123456789
Skip this step if you want archived channels to remain in their original category.
2

Archive a Channel

Run the command and confirm the prompt:
~archive #general
The bot will ask for confirmation. Click Confirm to proceed or Cancel to abort.
3

A Fresh Channel is Created

  • A new #general appears in the same position with the same permissions
  • The original is renamed #archived-general, hidden, and moved to the archive category (if set)
  • A message is posted in the new channel to let members know it’s a fresh start
4

Restore if Needed

Restore the original channel at any time:
~archive remove #general
The original is fully restored and the replacement is deleted.

Archive Category

Set Category

~archive category <id>
Archived channels move here automatically.

View Category

~archive category
Shows the currently configured archive category.

Clear Category

~archive category clear
Archived channels stay in their original category.

Tip

Create a dedicated 📦 Archives category and lock it down so only staff can see it.

What Gets Preserved

When a channel is archived and later restored, the following are fully saved and recovered:

Channel Data

  • Original channel name
  • Position in the channel list
  • Parent category
  • All permission overwrites

Bot Settings

  • Welcome message channel
  • Goodbye message channel
  • JoinPing channel

Permission Requirements

Bot Permissions

  • Manage Channels
  • View Channels
  • Send Messages
  • Manage Roles

User Permissions

  • Administrator — Required for all archive commands

Aliases

archive

Main command

arch

Short alias

Usage Examples

# Archive the current channel
~archive

# Archive a specific channel
~archive #off-topic

# Using the short alias
~arch #off-topic

Common Use Cases

~archive #general
The old messages are preserved in #archived-general (visible to staff), while members get a clean #general to start fresh in.
~archive #event-summer-2025
The channel is hidden away but can be restored later for reference or a returning event.
~archive #old-announcements
~archive #old-rules
Keep the history accessible to staff while presenting members with a cleaner layout.
~archive remove #general
Restores the original channel fully — name, position, and permissions.

Important Notes

Restore Requires the Original ChannelThe archived-{name} channel must still exist for archive remove to work. If it was manually deleted, the restore cannot proceed.
Confirmation RequiredEvery archive action requires clicking Confirm in the bot’s prompt. The confirmation expires after 15 seconds.
Best Practices
  • Set up a dedicated archive category before archiving channels
  • Use archive remove instead of manually deleting archived channels
  • Run archive help for a full in-Discord command reference

Role Permissions (Permit)

Delegate archive access to staff roles without granting full Administrator

Enable/Disable Commands

Control whether the archive command is available server-wide