Fix common problems

ZotLit not working as expected? Find what you see on screen and go straight to the fix.

Find what you see on your screen, and the link takes you to the fix.

Installing and connecting

A link opens Zotero instead of the PDF
The PDF does not open, or ZotLit says the file is missing — "This item has no PDF attachment."; "The PDF file is missing."
I cannot change annotations from Obsidian — "Zotero version is not supported"; "Enable communication with Zotero"; "Waiting for approval in Zotero"
A comment I wrote disappeared after I edited the same annotation in Zotero
An annotation shows a lock and I cannot change it — "Locked. Zotero imported this annotation from the PDF file, so it cannot be changed."

A citation shows as an error in the References sidebar — "@key matches no item in your Zotero library."; "@key matches multiple items in your Zotero library."; "This link has an invalid citation fragment."; "… points to an item that is no longer in your Zotero library."
ZotLit will not insert a citation — "Citation key @… matches multiple Zotero items. Change it in Zotero before inserting a citation."
Nothing is inserted when I pick a paper to cite — "Selected item has no citation key: …"
Copy bibliography is greyed out — "Fix the reference errors to copy the bibliography", "Bibliography formatting is unavailable"
The References sidebar says the style is unavailable or the references cannot be formatted — "This note's citation and references style is unavailable", "This note's document language is invalid", "ZotLit could not format these references", "The Pandoc engine is unavailable"
The References sidebar does not match what my note cites
Export fails or asks me to start Zotero or install the Pandoc engine
Native Pandoc export stops with an error code
The citation graph command opens nothing — "The Graph view core plugin is disabled. Turn it on in Settings → Core plugins."; "“Show citations in graph view” is turned off. Turn it on in Settings → ZotLit → Citations."