Translations of this page:

We’re in the process of updating the documentation for Zotero 5.0. Some documentation may be outdated in the meantime. Thanks for your understanding.

Why am I getting a database version error?

After reinstalling or downgrading Zotero, or when switching between Zotero for Firefox and Zotero Standalone, you may see the following error message when you you try to open Zotero:

This version of Zotero is older than the version last used with your database. Please upgrade to the latest version from zotero.org.

This message results from trying to use a Zotero database from a later version of Zotero in an earlier version of the software. For example, if you installed Zotero 5.0 but then reinstalled Zotero 4.0.29.15, you would get this error. Most Zotero versions preserve backward database compatibility, but occasionally it's necessary for Zotero developers to make changes to the database that prevent it from working with previous versions.

The best solution is generally to reinstall the latest version of Zotero from zotero.org. (If you were using a development build, you may need to reinstall the latest dev build.)

If for some reason you don't want to or are not able to install the latest version, you can restore the pre-upgrade database backup that Zotero stored in your Zotero data directory. Look for the zotero.sqlite.*.bak file with the highest number (e.g., zotero.sqlite.77.bak). Close Zotero/Firefox, move your existing zotero.sqlite file out of the way, and then copy the numbered backup file into place as zotero.sqlite. Then restart Zotero.

If you don't have data you care about, or if you've fully synced your data and files with your online account, you can keep your current Zotero version by closing Zotero/Firefox, deleting your Zotero data directory completely, and, optionally, syncing to restore your previous data.

Previously, the most common cause of this error was having used Juris-M (formerly known as MLZ). The current version of that software no longer causes this. See this post by Juris-M's developer on how to securely return to using regular Zotero.

kb/newer_db_version.txt · Last modified: 2017/11/12 19:53 (external edit)