Server Configuration

Backups

Create snapshots of your server and restore from them.

Overview

Create snapshots of your server's configuration and structure, then restore from them later. Backups capture roles, channels, emojis, stickers, and security settings. This is a premium feature requiring server administrator permissions.

Each account can store up to 5 backups. Restores can be run in merge (additive) or destructive (reset then restore) mode depending on your needs.

Getting Started

Create your first backup by giving it a name. The backup captures everything about your server at that moment.

,backup create (name) [description]

You can optionally add a description to help you remember what each backup is for. Names can be up to 100 characters.

Core Commands

Creating & Viewing Backups

Restore from Backup

Choose between merge (default) and destructive restore modes. Both require confirmation before executing.

,backup restore (id) [mode]

Destructive restore deletes all existing roles and channels before restoring from the backup. This is irreversible and cannot be undone. Only use this if you are certain you want to reset your server structure.

Loss details:

  • All existing roles (except @everyone) are deleted before new ones are created.
  • All channels are deleted before backup channels are recreated.
  • Messages are not affected, but channel structure and permissions are reset.
  • Custom Discord settings (boosts, features, guild flags) are not backed up and will not be restored.
  • Any settings stored only in Discord (invite splash, banners, role colors, etc.) are not covered.

Merge mode is safer: it keeps existing channels and roles that match names, only adding missing items.

Restore operations are throttled (250ms per role/channel) to avoid hitting Discord's rate limits. Large restores may take several minutes.

Managing Backups

What Backups Include & Exclude

Captured

  • Roles: Name, color, permissions, icon, position, hoisted flag, mentionable flag.
  • Channels: Type (text/voice/category/forum/stage), name, topic, permissions, slowmode, nsfw flag, parent category.
  • Emojis: Custom emoji with their names and restrictions.
  • Stickers: Custom stickers.
  • Security: Channel-specific overwrites (role/member permissions), role hierarchy order, default member permissions.

Not Captured

  • Messages: Message content is never backed up.
  • Bots & Integrations: Bot roles, webhooks, application commands.
  • Discord-native Settings: Server name, region, verification level, 2FA requirement, explicit filter, notification defaults, invite splash, banner, icon, community flag, vanity URL.
  • User Data: Member join dates, roles per user, server nicknames.
  • Temporary State: Voice channel activity, thread activity, pins.

Backups are personal to your user account. If you restore a backup in a different server, the server IDs in permissions will not transfer correctly. This is a Discord limitation.

Common Scenarios

Scenario: Recovering Deleted Roles

Problem: You accidentally deleted several roles. Solution: Use merge mode to restore them without affecting current channels.

,backup restore abc123 merge

Scenario: Resetting a Corrupted Server

Problem: Your server structure is a mess and you want to start fresh from a known good state. Solution: Use destructive mode (be very careful).

,backup restore abc123 destructive

Limits & Constraints

  • Max Backups: 5 per account (premium feature).
  • Max Backup Size: No hard size limit, but very large backups may take longer to create/restore.
  • Backup Name: 1–100 characters.
  • Backup Description: 0–500 characters.
  • Restore Throttle: 250ms per role/channel to respect Discord rate limits.
  • Premium Gate: Requires an active premium subscription on the server.

Troubleshooting

Restore failed: If a restore fails partway through, some items may be partially applied. Check your audit log and re-run the restore or manually clean up.

Role permissions not restored: Ensure the bot's highest role is positioned above the roles being restored. The bot cannot create roles higher than itself.

Channel overwrites missing: If a role referenced in channel permissions doesn't exist, that overwrite will be skipped during restore.

Emojis not restored: Discord has emoji slot limits based on server tier. If you exceed your tier's limit, emoji restoration will fail. Upgrade your server or delete emojis first.

Backup size very large: If a backup is over 100MB or captures thousands of items, creation/restore may be slow. This is expected behavior.