Import from a file

1. Open XTagger → Import tab
2. Drag a .xtagger.json file onto the drop zone, or click browse to pick one
3. Click Preview — XTagger shows you what will change before touching anything:
   • How many users will be affected
   • How many new tags will be added
   • Whether there are conflicts with tags you already have
4. If there are conflicts, choose a strategy:
   • Keep mine — your existing tags win
   • Keep theirs — the imported tags replace yours
   • Keep both — both versions are kept (you may end up with duplicates)
5. Click Import

Import from a XTAG: string

If someone sent you a XTAG:... string in a message:

1. Open XTagger → Import tab
2. Paste the string into the Paste area
3. Click Preview, then Import

What happens to existing tags?

XTagger merges imports into your existing data — it never deletes tags you already have unless you choose Keep theirs on a specific conflict. Users who appear in the import but aren’t in your collection are simply added.

Verifying a collection’s source

When you preview an import, check the Integrity badge:

• ✓ Checksum valid — the file hasn’t been modified since it was exported
• ⚠ Checksum mismatch — the file was edited after export, which could be benign (manual fix) or worth questioning

If the collection was created by someone with a Nostr keypair and signed, a future version of XTagger will verify the signature and show the creator’s npub. For now, trust the person who sent it to you.