đź“‹ How-to guide

Share your tags as a file

The most reliable way to share tags is as a .xtagger.json file.

  1. Open the XTagger popup (click the 🏷️ icon in your toolbar, or press the extension button)
  2. Go to the Export tab
  3. Choose All tags for a full backup, or Collection to share a filtered subset
  4. Click ⬇ Download to save the file
  5. Send the file to the other person — email, Nextcloud, Signal, wherever

The recipient opens XTagger → Import tab → drops the file in.

Share a compact XTAG: string

For sharing in a tweet, DM, or chat message, use the compact format:

  1. Export as above, then click ⧉ Copy XTAG instead of downloading
  2. Paste the XTAG:... string into a message
  3. The recipient pastes it into XTagger → Import → Paste area → Preview → Import

The compact format is base64-encoded and fits in most character limits, though for large collections (500+ users) a file is more practical.

Share a named collection

If you only want to share a subset — for example, everyone you’ve tagged “Journalist” but not “Inactive”:

  1. Export tab → Collection tab
  2. Add tags to Include (any) — users need at least one of these
  3. Optionally add Include (all) — users must also have all of these
  4. Optionally add Exclude — removes anyone with these tags
  5. Click Preview to confirm the count, then Export collection

The exported file includes the collection name and criteria, so the recipient can see exactly what it represents.

Via Nextcloud shared folder

If your group uses Nextcloud:

  1. Export your collection to a .xtagger.json file
  2. Drop it into a shared Nextcloud folder
  3. Others with folder access download and import it

Nextcloud’s version history tracks updates; you can replace the file with a newer export and others will see it has changed.

✎ Edit this page on Forgejo