Backup Commands

Complete guide to Backup module commands and features

📦 Backup Commands

📦 Backup & Restore

Backup and restore your group settings using these commands:

Admin Commands:

/export - Export all group settings to a JSON file
/export notes filters rules - Export specific modules only

Creator Commands:

/import - Reply to a backup file to restore settings
/import notes filters - Import only specific modules
/reset - Reset all settings to default
/reset warns locks - Reset specific modules only

Rate Limits:

Export: 1 per 5 minutes
Import: 1 per 10 minutes
Reset: 1 per hour

Module Aliases

This module can be accessed using the following aliases:

export
import
reset

Backups cover 19 modules: admin, antiflood, antiraid, approvals, blacklists, captcha, connections, disabling, federations (the chat’s federation membership), filters, greetings, locks, logchannels (the log channel setting), notes, pins, reactions, reports, rules, and warns. A bare /reset resets all 19, so it also removes the chat from its federation and unsets its log channel; pass module names (e.g. /reset locks notes) to reset only those. Import and reset are transactional: if one selected module fails, no selected module is changed.

Available Commands

Command	Description	Disableable
`/export`	Export all group settings to a JSON file	❌
`/import`	Reply to a backup file to restore settings	❌
`/reset`	Reset all settings to default	❌

Usage Examples

Basic Usage

/export
/import
/reset

For detailed command usage, refer to the commands table above.

Required Permissions

All three commands work only in groups (RequireGroup); in a private chat the bot replies with the group-only error. None of them can be turned off with /disable.

/export — Requires Admin (RequireUserAdmin + RequireBotAdmin). Rate limited: 1 per 5 minutes.
/import — Requires Group Creator (RequireUserOwner + RequireBotAdmin). Rate limited: 1 per 10 minutes.
/reset — Requires Group Creator (RequireUserOwner + RequireBotAdmin). Rate limited: 1 per hour.

Confirmation Flow

Both /import and /reset require explicit confirmation before executing:

After parsing the backup file (or reset modules), the bot shows a message listing which modules will be affected.
An inline keyboard with Confirm/Cancel buttons is attached:
- Confirm — Executes the operation immediately.
- Cancel — Cleans up pending state and aborts.
Only the group creator can click either button; non-creators see an alert.

Version Compatibility

The current backup format is 1.1. Imports also accept legacy 1.0 files while preserving notes settings and user warning rows that 1.0 did not export. Unsupported versions are rejected before the confirmation step.