Skip to main content
The Backup & Templates page lets you save your server’s Percy configuration as a portable file, restore it later (or into a different server), and publish it as a template others can reuse. It’s the fastest way to clone a working setup or recover after a mistake. Find it under Integrations → Backup & Templates on the dashboard. It requires the Manage Server permission.

​
What’s in a backup

A backup is portable — it contains only configuration that makes sense in any server, with no channel or role IDs baked in:
Features bound to specific channels or roles — comic feeds, temp-channel hubs, log channels — are deliberately excluded so a backup restores cleanly into any server without pointing at IDs that don’t exist there.

​
Exporting

Click Download backup to save a JSON snapshot of the current configuration. Keep it somewhere safe, or hand it to another server owner to import.

​
Importing / restoring

1

Load the backup

Paste a backup’s JSON, or choose a .json file to load it into the box.
2

Preview

Click Preview. Percy performs a dry run and shows exactly how many items each section would add — nothing is written yet.
3

Restore

Click Restore to apply it.
Import is additive. Existing tags and autoresponder triggers with the same name are skipped, never overwritten, so a restore can’t clobber work you’ve already done.

​
Templates

A template is a backup published under a slug — a short, lowercase name like gaming-starter. Templates let other servers apply your setup without you sending a file around.

​
Publishing

Fill in a slug, a display name, and an optional description, then choose whether to make it public. Public templates appear in the gallery for any server to apply; private ones are visible only to the server that published them.

​
Applying

Both your own templates and public ones can be applied to the current server. Applying previews the changes first (a dry run), then adds the template’s content additively — exactly like an import.

​
Managing

Your published templates show their usage count. You can delete any template your server authored at any time.

​
Next steps

Webhooks

Send signed server events to your own services.

Server Setup

Run through the full initial setup checklist.