# Backup Commands

Backups capture a snapshot of your guild so you can restore roles, channels, messages, bans, emojis, events, and guild settings later.

# Quick start

Create a backup: /backup create name:"My Guild" custom-id:my-guild
List your backups: /backup list
Restore it: /backup load backup-id:my-guild

# /backup create

# Syntax

/backup create name:"My Guild" custom-id:my-guild

# Options

Option	Description	Required
`name`	Backup name. Defaults to guild name.	No
`custom-id`	A short custom identifier for this backup.	No

# Requirements

Requirement	Notes
`Administrator`	Required for the user.
Config `ownerOnly`	If enabled, only the guild owner can use major commands.

# Notes

custom-id cannot be blank.
Backups are subject to user and guild cooldowns.

# /backup load

# Syntax

/backup load backup-id:my-guild exclude:roles

# Options

Option	Description	Required
`backup-id`	Backup ID or custom ID. Use `blank` to delete without loading.	Yes
`exclude`	Components to leave untouched during load.	No

# Exclude values

roles, bans, emojis, channels, events, guild

# Requirements

Requirement	Notes
`Administrator`	Required for the user.
`Administrator`	Required for the bot.
Config level `advanced`	Required for non-owners to load backups.
Config `ownerOnly`	If enabled, only the guild owner can use major commands.

# Notes

Only one backup load can run per guild at a time.
You will be prompted to confirm which components to load or delete.

# /backup list

# Syntax

/backup list page:1

# Options

Option	Description	Required
`page`	Page number to display.	No

# /backup preview

# Syntax

/backup preview backup-id:my-guild

# Options

Option	Description	Required
`backup-id`	Backup ID or custom ID.	Yes

# Notes

Shows a preview of roles, channels, threads, and emojis from the backup.

# /backup status

# Syntax

/backup status

# Requirements

Requirement	Notes
`Manage Guild`	Required for the user.

# Notes

Shows which categories are actively loading and provides a time estimate when available.

# /backup cancel

# Syntax

/backup cancel

# Notes

Cancels the current load started by your user in this guild.

# /backup delete

# Syntax

/backup delete backup-id:my-guild

# Options

Option	Description	Required
`backup-id`	Backup ID or custom ID.	Yes

# Notes

Requires confirmation before deletion.

# /backup prune

# Syntax

/backup prune guild-name:"My Guild"

# Options

Option	Description	Required
`guild-name`	Prune backups by matching guild or backup name.	No

# /backup watch

# Syntax

/backup watch interval:3h stop-watching:false

# Options

Option	Description	Required
`interval`	How often to create a backup, e.g. `3m` or `180000`.	Yes
`stop-watching`	Stop creating automatic backups for this guild.	No

# Requirements

Requirement	Notes
`Administrator`	Required for the user.
Config level `advanced`	Required for non-owners to use destructive actions.
Config `ownerOnly`	If enabled, only the guild owner can use major commands.

# Notes

Interval must be at least 12 minutes and no more than 30 days for non-devs.
Auto-backup count is limited by your plan tier.