Server configuration
Backups
Create snapshots of your server and restore from them.
Slash commands for this page
Set this up in Discord with /configure feature:Backups.
Use the slash version of each command below. Prefix commands keep working until March 5, 2027. What is changing
,backup→/configure feature:Backups,bk→/configure feature:Backups,backup create→/configure feature:Backups,backup list→/configure feature:Backups,backup view→/configure feature:Backups,backup rename→/configure feature:Backups
,backup restore→/configure feature:Backups,backup delete→/configure feature:Backups
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],backup create "Main Setup"
,backup create "Gaming-Themed" "Custom roles and channels for gaming"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
,backup create (name) [description]: Create a new backup snapshot.- Name: Required, up to 100 characters.
- Description: Optional, up to 500 characters.
- Returns the backup ID and size in bytes.
,backup listor,backupor,bk: View all your backups with creation dates, role/channel counts, and size.,backup view (id): Inspect a single backup's contents (roles, channels, emojis, stickers, size).
,backup rename (id) (name) [description]: Update a backup's name and/or description after creation.
You can ask the assistant in the dashboard to save a backup, for example before it makes a big change, and to list the backups you can see in this server. You need Administrator and Server Premium, and the backup belongs to you, so it counts toward your 5. Restoring is always done with a command, never by the assistant.
Restore from Backup
Choose between merge (default) and destructive restore modes. Both require confirmation before executing.
When a restore finishes, greed shows a summary with the first 10 problems it ran into. If there were more, the full list is attached as a restore-errors.txt file so nothing is hidden. Restores started from /configure send the same file to you privately.
,backup restore (id) [mode],backup restore abc123
,backup restore abc123 destructiveDestructive 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.
Merges the backup with your current server structure:
- Existing roles with matching names are kept.
- New roles from the backup are created.
- Existing channels with matching names are kept.
- New channels from the backup are created.
- Emojis and stickers are added (duplicates are skipped).
- Security settings and permissions are merged intelligently.
Use for: Recovering specific items without resetting your current setup.
,backup restore abc123
,backup restore abc123 merge
Resets your server and applies the backup from scratch:
- All existing roles (except @everyone) are deleted.
- All existing channels are deleted.
- All backup roles and channels are created.
- Emojis and stickers are added.
- Security settings are fully replaced.
Use for: Complete server resets or recovering from corruption.
,backup restore abc123 destructive
Restore operations are throttled (250ms per role/channel) to avoid hitting Discord's rate limits. Large restores may take several minutes.
Managing Backups
,backup delete (id)or,backup remove (id): Permanently delete a backup. This cannot be undone.
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 mergeScenario: 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 destructiveLimits & 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.