Documentation

Backup & Migration Guide

Export, back up, and restore your Team Up leaderboards — or transfer them to a new Discord server

Jump to Section

📋 Overview 💾 Backup & Restore 🔁 Transfer Servers

Overview

Team Up lets you export any leaderboard to a JSON file and re-import it later — for backups, disaster recovery, or moving a community to a new server.

Import Options

/backup import - Restore from a Team Up export file

Export Options

/backup export - Export leaderboard as JSON
Includes ratings, match history, and profiles

Rate Limits

Free Tier

5 exports per day
2 imports per day
1 MB max file size
100 history records

Pro Tier

100 exports per day
50 imports per day
20 MB max file size
5,000 history records

Backup & Restore (Team Up Format)

Export Your Leaderboard

Create a complete backup of your leaderboard data including ratings, match history, and profiles.

/backup export leaderboard:"default"

Downloads a JSON file with all leaderboard data

Team Up Export Format

The exported file contains comprehensive leaderboard data:

{
  "leaderboard_info": {
    "leaderboard": "default",
    "display_name": "Default Leaderboard",
    "elo_default_rating": 1200,
    "matches_required_for_ranking": 0
  },
  "ratings": [
    {
      "id": "123456789012345678",
      "team": ["123456789012345678"],
      "elo": 1450,
      "matches": 25,
      "rating_type": "player_global_even",
      "leaderboard": "default"
    }
  ],
  "history": [...],
  "profiles": {
    "players": [...],
    "teams": [...]
  }
}

Restore from Backup

Import a Team Up export file to restore or transfer leaderboard data.

/backup import data_file:[attach your .json file] leaderboard:"default"

Restores all data including ratings, history, and profiles

Important Notes

Importing to an existing leaderboard will merge data, not replace it
Duplicate player IDs will have their ratings updated
Match history is additive - new records are appended
Server admin permissions are required for backup commands

Transferring to a New Server

Moving your community to a new Discord server? Export from the old server and import into the new one.

1. Export from the old server

/backup export leaderboard:"ranked"

2. Add Team Up to the new server

Invite the bot and make sure you have admin permissions.

3. Import the backup file

/backup import data_file:[your file] leaderboard:"ranked"

Note on User IDs

Discord user IDs must match between servers. Players who aren't in the new server will still have their ratings preserved, but won't appear with updated names until they join.