Import and export

The four formats

Every export covers your whole library, a single game, or a single preset. You choose the scope on the Export page, and whether archived games and presets are included.

• JSON — the complete one. This is the backup to keep, and the only format that can be imported back.
• Markdown — for reading and pasting: one heading per game, preset and category, then - Name: value lines.
• CSV — one row per setting, for a spreadsheet: game,preset,category,setting,type,value,unit,notes.
• ZIP — all three of the above in one download.

What the JSON contains

One document with your games, and inside each game its presets, categories and settings. Each setting keeps its type, its value, its unit, its allowed range or options, its default, and your own description and notes — so a restored preset is the same preset, not a list of numbers.

{
  "format": "gamesettings-vault",
  "version": 1,
  "kind": "library",
  "exportedAt": "2026-09-22T10:00:00.000Z",
  "games": [
    {
      "name": "Counter-Strike 2",
      "presets": [
        {
          "name": "Competitive",
          "isDefault": true,
          "categories": [
            {
              "name": "Mouse",
              "settings": [
                { "name": "Sensitivity", "type": "decimal", "value": 2.4 }
              ]
            }
          ]
        }
      ]
    }
  ]
}

The format string is the original internal name of the file type and has not been changed, so that files exported a year ago still import today.

What is not in it

A cover image you uploaded stays on the server; the file keeps only a link if the cover came from a URL. Snapshot history is not exported — an export is the current state of each preset, not every version of it. Nothing about your account, your password, your devices or your payments is in the file.

When someone else exports one of your public presets, your private notes are removed from that copy. They are yours, and they do not travel with a shared preset.

Putting a backup back

The Import page walks through Source → Review → Import. Upload the JSON file or paste it in, look at every game, preset and setting it proposes, then confirm. Nothing is written to your library until that last step, and reviewing or comparing never changes anything.

A game whose name matches one you already have is merged into: its presets arrive alongside your existing ones rather than replacing the game. You can also pick which game they should land in.

When a preset already exists

Presets are matched by name. You choose what happens to the whole file, and can then override any single conflict:

• Keep both — the default. The incoming one arrives as a numbered copy, Competitive (2). Nothing you had is touched.
• Skip duplicates — the preset you already have wins, and the incoming one is discarded.
• Replace existing — the matched preset and its snapshot history are deleted before the replacement is written. If it was the default preset, the replacement takes that role.

Compare differences puts the current and incoming values side by side, using the same comparison the app uses everywhere else, before either is changed.

Importing a game's own config files

The same page has a Game config tab for the other direction: pick a game from the catalog and drop its real config files in, in any order. Filenames are matched against the catalog, including Counter-Strike 2’s per-user slot folders and its .vcfg files.

The review step marks every value that was not found in your files as Catalog default, so you can tell what the game actually told us from what is merely the usual value. If nothing could be read, import stays disabled rather than saving an empty preset.

If the file is wrong

The file is checked before anything is written, and a problem is reported with the exact place it was found — games[0].presets[1].name — while your library is left untouched. Fields we do not recognise are ignored rather than rejected, so a file from a newer version still imports.

One file can carry up to 500 games, 200 presets per game, 200 categories per preset and 1 000 settings per category. A normal library is nowhere near any of these.