Solutions

XnView MP Tags Lost on Migration: Why It Happens and How to Fix It

By refernLast updated June 202610 min read

By refern | Last updated: June 2026

XnView MP stores its categories, labels, and ratings in an internal database that does not travel with your image files. When you move to a new computer, reinstall XnView, or hand your image folder to someone else, all that tag work disappears. This is a known architectural limitation, not a bug. The fix is to use a tool whose metadata index lives inside the image folder itself.

This page explains why XnView MP tags are lost on migration, how its catalog model works, what your options are, and how refern approaches portable tagging differently. Because XnView MP is a genuinely capable free tool, the honest comparison matters: some users will stay with it and just needs to know how to back up their catalog properly. Others will decide the portability risk is not worth it.

Why XnView MP tags disappear when you migrate

XnView MP stores categories, color labels, and ratings in its own internal database, not in the image files themselves. According to the official XnView forum, this is by design: "Only XnViewMP will be able to read its own catalog." [source: XnView MP official forum]

When you move your image folder to a new computer, you are moving the images. The XnView database stays on the old machine in a separate location, typically in your user profile or AppData folder. Your images arrive on the new machine tag-free.

There is a workaround: you can manually copy the XnView database folder from the old machine to the new one. But this is not a documented migration workflow, it requires knowing where the database lives, and it is fragile if the installation paths differ between machines. Users have also reported tags vanishing without any migration at all: version updates can break tag display, and some users report needing to press F5 to refresh the browser before tags appear. [source: XnView MP official forum tagging bug threads]

The forum thread is direct: if your tags are only stored in XnView's internal catalog, they are locked to that installation.

The root cause: database-separate-from-files

Most image viewers with a tagging feature face the same tradeoff:

  • Embed metadata in the file (EXIF/XMP/IPTC): Tags travel with the file permanently. Every tool that can read EXIF/XMP can see them. Downside: not every format supports it, and writing to files is a destructive operation that some users prefer to avoid.
  • Store metadata in an internal database: Fast, flexible, supports rich data structures. But the database is only as portable as you make it. If it lives in a user profile folder rather than alongside the files, migration breaks it.

XnView MP defaults to the internal database approach. Unless you explicitly configure it to write tags to file metadata (which not all formats support cleanly), your tagging data lives in one place: the XnView catalog on that specific machine.

What XnView MP does well (be fair to the tool)

Before going further, it is worth being clear: XnView MP is genuinely capable, and for many users it is the right tool.

  • Completely free for personal and educational use. Commercial licenses start at EUR 29 per seat (as of 2026). [source: xnview.com]
  • Supports 500+ image and video formats, including RAW, HEIC, PSD, JPEG2000, DNG, and many obscure formats. Few tools match this breadth. [source: xnview.com]
  • Runs on Windows, macOS, and Linux, including ARM64 Linux. [source: xnview.com]
  • Does not copy your files. It browses your images in place, just like a file explorer.
  • Fast and lightweight on old hardware.
  • Batch rename, batch convert, duplicate detection, and EXIF metadata editing are all included.

If you manage a large, format-diverse image collection, work offline, do not frequently switch computers, and do not need a canvas or graph view, XnView MP earns its place. Its tagging system is a known limitation, not a dealbreaker for everyone.

The portable catalog alternative: metadata that lives in the folder

The solution to the migration problem is conceptually simple: put the metadata index inside the image folder, not in a separate application database. When you move the folder, the index moves with it.

Two tools take this approach:

TagStudio is free and open-source. It stores all tag data in a .TagStudio/ts_library.sqlite file at the root of your library folder. Copy the folder, bring the .TagStudio subfolder, and your tags come with it. TagStudio has a rich hierarchical tag system with parent-child inheritance, aliases, and namespaces. [source: TagStudio GitHub and documentation]

However, TagStudio is still in alpha as of mid-2026. Users report sluggishness on large libraries due to its Python runtime. It has no canvas, no color search, no browser extension, no visual similarity, and no Eagle import. Development cadence has been slow, with roughly a six-month gap between some releases. If free and open-source is your hard requirement and you only need tag-based organization, TagStudio is worth trying, with the caveat that it is not yet production-ready. [source: TagStudio AlternativeTo user reviews; GitHub Discussion #1022]

refern stores its index in a SQLite file inside the workspace folder. A workspace is just a normal folder on your disk; refern never copies your images. Move or copy that folder to a new computer, point refern at it, and everything is already there: tags, ratings, notes, descriptions, source URLs, color labels, and search index. There is no export or import step.

refern costs $30 one-time (launch pricing, going to $35 about two months after launch). It is not free like XnView MP or TagStudio.

Comparing the three approaches

FeatureXnView MPTagStudiorefern
PriceFree (personal/educational)Free (GPL open source)$30 one-time (launch price)
Tags survive folder moveOnly if manually backed upYes (.TagStudio subfolder travels)Yes (SQLite index in workspace folder)
Tags survive reinstallOnly if database manually restoredYesYes
Format breadth500+ formatsBroad (RAW, PDF, SVG, video)Images, video, PDF, canvas; creative source files indexed
Infinite canvasNoneNoneYes
Color searchNoneNoneYes, local
Visual similarity searchNoneNoneYes, local
Browser extensionNoneNoneChrome, Firefox, Safari
Relationship graphNoneNoneYes
Performance at scaleFast (C-based)Sluggish (Python)Fast (Rust)
Active developmentYesAlpha, slow cadenceYes, 1.0 shipped
Linux supportYesYesYes
Open sourceNoYes (GPL-3.0)No

How refern handles tag portability

refern is built around the principle that your data belongs to you and should travel with your files.

When you create a workspace in refern, you point it at an existing folder. refern writes a SQLite index into that folder (alongside a thumbnails subfolder). Your original files are never moved, renamed, or copied. The index stores:

  • Hierarchical tags with tag groups, linked tags, and macros
  • Ratings (1 to 5 stars), color labels, favorites
  • Descriptions, notes, source URL, creator
  • Content tags applied from embedded EXIF/IPTC/XMP metadata on import
  • Full-text search index (SQLite FTS5)

To move to a new computer: copy your image folder, install refern on the new machine, open the folder. Done. No export, no import, no settings to recreate.

Because refern reads embedded image metadata on import (EXIF, IPTC, XMP), images that already have keywords embedded in their metadata have those keywords applied automatically as tags when first indexed.

What refern cannot do

To be honest about the tradeoffs:

  • It costs $30. XnView MP and TagStudio are free.
  • It does not write tags back to image EXIF/XMP fields. The index is local to refern. If you move to a different tool later, your tags do not automatically come with you (though the SQLite database is a standard format a developer could read).
  • It does not support 500+ image formats the way XnView MP does. RAW files are indexed and previewed via thumbnail; AVIF is not yet supported.
  • It does not have XnView's batch conversion or batch renaming tools. refern is a reference manager, not an image processor.
  • There is no cloud sync or sharing today. Those are planned for a future phase.

How to keep XnView MP tags safe today (if you stay with it)

If you decide to keep using XnView MP but want to protect your tags, here are the practical steps:

Option 1: Write tags to file metadata. In XnView MP settings, enable writing categories and labels to EXIF/IPTC/XMP metadata fields. This embeds tag data directly in files that support it (JPEG, PNG, TIFF). Tags then survive any migration because they live in the file. The downside: not every format supports embedded metadata, and writing to files is a change to the file itself.

Option 2: Back up the XnView catalog manually. Locate the XnView database folder (typically in your user profile under AppData on Windows). Copy it to an external drive or cloud storage. Before migrating, copy it to the same path on the new machine before launching XnView. This works but is fragile if paths differ.

Option 3: Use a tool with a portable index. If tag portability is a recurring concern for you, consider a tool whose design makes this automatic rather than manual.

Frequently asked questions

Why do XnView MP tags disappear when I move to a new computer?

XnView MP stores categories, labels, and ratings in its own internal database, not embedded in image files. Moving to a new computer does not move this database, so all tag data stays on the old machine. Only metadata written directly to EXIF or XMP fields survives a migration.

Can I export my XnView MP catalog to use on another computer?

XnView MP does not have a simple one-click catalog export for migration. You can manually back up the XnView database folder and restore it on the new machine, but this is error-prone and undocumented in the standard help resources. Any tags not written to file metadata are at risk.

What is a portable image catalog?

A portable catalog is a metadata index stored inside the same folder as your images, so moving or copying your image folder automatically brings all tags, notes, and ratings with it. You do not need to export or import anything separately when switching computers.

Does refern keep tags if I reinstall or switch computers?

Yes. refern writes its SQLite index into the workspace folder alongside your images. Copy or move the folder to a new machine, open refern, point it at the folder, and all tags, ratings, notes, and search data are already there.

Is XnView MP free?

Yes. XnView MP is freeware for private and educational use. Commercial use requires a license starting at EUR 29 per seat (as of 2026). It supports 500+ image formats and runs on Windows, macOS, and Linux.
  • $30 one-time, no subscription
  • Windows, macOS, Linux
  • Local-first and private
  • 10,000+ creatives
  • Community on Discord
“Organization and search like Eagle cool, canvas from PureRef.”
An early refern user

Try it yourself

One library for your references, with a canvas built in.

refern keeps your images organized and searchable, gives you an infinite canvas to arrange them, and read your files as is. $30 one-time, lifetime updates.

No account required. Cancel anytime during the trial.

Sources

  1. 1.XnView MP features, pricing, and platform support
  2. 2.XnView MP official forum thread on tagging bugs
  3. 3.XnView MP official forum: tags stored in internal catalog not portable
  4. 4.XnView MP user reviews and complaints
  5. 5.XnView MP UI and limitations critique