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

Simplified Chinese content is not ready. English content is shown.

Read in English
ZotLit

How to fix Zotero changes that do not appear

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

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 数据库, enable 为 Obsidian 保持数据库文件最新. New Companion installations enable this setting by default.

Make recent changes available

In Zotero's item pane, select 数据库状态 beside Locate. If 立即将更改写入数据库文件 is available, select it.

This makes recent Zotero changes available immediately.

Update the literature note

Return to the literature note in Obsidian. Run ZotLit: 更新文献笔记.

The missing Zotero change should now appear in the note.

Refresh ZotLit

If the note still shows old data, run ZotLit: 刷新 Zotero 数据库. Then update the literature note again.

Advanced: Use Full copy as a last resort

If the problem continues, open Settings > ZotLit > Zotero > Zotero 位置. Set 读取模式 to 完整副本, refresh the database, and update the literature note again.

完整副本 copies the entire database on every refresh. Large Zotero libraries take longer to refresh and use more disk space.

Report a remaining problem

If 完整副本 also fails, collect debug logs. Then file a bug report with your ZotLit version, operating system, and reproduction steps.

See also

Last updated on

On this page