You’re reading the ZotLit v2 docs. Still on v1? Read the v1 docs

ZotLit

How to fix Zotero changes that do not appear

Update your connection when Zotero changes do not appear in a literature note.

Available sinceZotLit 2.0.0

Use this guide when Zotero changes do not appear after you update a literature note in Obsidian.

Restore current Zotero data

Install or update ZotLit Companion

ZotLit Companion, the Zotero add-on, keeps recent Zotero changes available to ZotLit. Install the latest Companion, or update your current installation in Zotero.

Confirm the Companion setting

In Zotero, open Edit → Settings on Windows or Linux. On macOS, open Zotero → Settings. Select the ZotLit pane.

Under Database, enable Keep the database file up to date for Obsidian. New Companion installations enable this setting by default.

Make recent changes available

In Zotero's item pane, select Database Status beside Locate. If Write Changes to Database File Now is available, select it.

This makes recent Zotero changes available immediately.

Update the literature note

Return to the literature note in Obsidian. Run ZotLit: Update literature note.

The missing Zotero change should now appear in the note.

Refresh ZotLit

If the note still shows old data, run ZotLit: Refresh Zotero database. Then update the literature note again.

Advanced: Use Full copy as a last resort

If the problem continues, open Settings → ZotLit → Zotero database. Set Read mode to Full copy, refresh the database, and update the literature note again.

Full copy copies the entire database on every refresh. Large Zotero libraries take longer to refresh and use more disk space.

Report a remaining problem

If Full copy also fails, collect debug logs. Then file a bug report with your ZotLit version, operating system, and reproduction steps.

See also

On this page