> For the complete documentation index, see [llms.txt](https://zoomiescore.gitbook.io/zoomiescore-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zoomiescore.gitbook.io/zoomiescore-docs/docs/features/backups.md).

# backups

Snapshot your server's structure and restore it later — great for templates, disaster recovery, or copying a layout to a new server.

## What's captured

* **Roles** — name, color, hoist, mentionable, permissions bitmask, position order. (Not: member assignments.)
* **Categories** — name + position.
* **Text channels** — name, topic, slowmode, NSFW flag, parent category, position.
* **Voice channels** — name, user limit, bitrate, parent, position.
* **Channel permission overrides** — for every role and every channel.
* **Server settings** — icon, banner, verification level, explicit content filter, default notifications, system channel.

## What's NOT captured

* Messages / message history.
* Members / member roles.
* Emojis / stickers (Discord's own asset limits make this messy).
* Webhooks / integrations.

## Slash commands

```
/backup create name?      → Snapshot the current server (premium)
/backup list              → Recent backups for this server
/backup restore id:       → Apply a snapshot to the current server
/backup delete id:        → Delete a saved backup
/backup download id:      → DM you a JSON dump of the backup

/backups                  → Manage backups from Discord (opens picker)
```

All backup commands require **Manage Server**.

## Restore behavior

Restores are **additive by default** — the bot creates missing roles and channels but won't delete extras. A **destructive** mode (via dashboard) removes anything not in the backup, matching the snapshot exactly.

A restore report DMs the invoker with:

* Roles created / skipped (with reason)
* Channels created / skipped
* Permissions applied / failed

Skipped items usually mean the bot lacked **Manage Roles** or **Manage Channels** at that point — grant the permission and re-run.

## Limits

* Backups per guild: **20** (oldest auto-pruned).
* Backup size limit: 5 MB (structure only, so this is huge in practice).