๐Ÿ“‹ How-to guide

Export your tag collection

Goal: Produce a complete backup of all your tags, ready to import on another device or share with someone.


Export via the popup

  1. Click the ๐Ÿท๏ธ XTagger icon in your browser toolbar
  2. Navigate to the Export tab (second icon in the nav bar)
  3. Choose your format:
    • JSON file โ€” saves xtagger-export.json to your downloads folder
    • XTAG: string โ€” copies a single compact string to your clipboard
  4. Click Export

The JSON file and the XTAG: string contain identical data. Use JSON for backups, XTAG: for sharing.


Filter the export

To export only a subset of your tags:

  1. On the Export tab, expand Advanced options
  2. Enter one or more usernames to include (leave blank for all)
  3. Or filter by tag name โ€” e.g. export only tags named journalist

What the export contains

FieldDescription
schemaVersionFormat version (currently 1)
platformAlways x.com for now
exportedAtISO 8601 timestamp
checksumSHA-256 of the entries โ€” verified on import
entriesAll tags, keyed by platform:username

See the XTAG: format specification for the complete schema.


Automate backups

XTagger does not schedule automatic exports โ€” that would require persistent background access, which is outside the privacy model. For regular backups, set a calendar reminder to export once a week via the popup.

โœŽ Edit this page on Forgejo