Sync your bibliography with Zotero
Sarmate can fetch your Zotero library and write it into a .bib file in your space, ready to cite in your LaTeX documents. Syncing is one-way: Zotero → Sarmate. You manage your references in Zotero; Sarmate only copies them.
Before you start
- Your Zotero library must be synced with the Zotero cloud: Sarmate reads the online version of your library, not the one stored on your computer. (In Zotero: Preferences → Sync → connect your account and sync.)
- Tip: group the references you want to cite into a Zotero collection so you don't import your whole library.
Step 1 — Get a Zotero API key
- Open your account's keys page: www.zotero.org/settings/keys.
- Click “Create new private key”. Read-only access is enough.
- Copy the key shown: it is displayed only once.
Step 2 — Link a .bib file to Zotero
- In your Sarmate file manager, find (or create) the
.bibfile to link. - Click the three vertical dots to the right of the file, then “Link to Zotero”.
- Paste your API key and click “Test”.
- If the connection is valid, choose the source: your whole library or a collection (the reference count is shown).
- Click “Link” then “Sync”.
Your
.bib file will be overwritten
On linking, the existing content of the .bib file is replaced by the bibliography chosen in Zotero. If you had added entries by hand, keep them in another file.
Step 3 — Cite in your document
Include the file in your document, then cite as usual. Reference auto-completion appears as soon as you type the opening brace \autocite{.
LaTeX
\usepackage[backend=biber,style=verbose-trad2]{biblatex}
\addbibresource{my-bibliography.bib} % the file linked to Zotero
% ...
As shown by \autocite{key2020}, ...
% ...
\printbibliography
With classic BibTeX, use \bibliography{my-bibliography} and \cite{...} instead.
Updating the bibliography
Syncing is not automatic. After each change in Zotero (and once Zotero has re-synced to the cloud), come back to Sarmate and click “Sync” again to update the .bib file.
Troubleshooting
“error_Zotero empty library” or no reference imported
The chosen source (often a collection) contains no references visible online. Check that the collection does contain references and that Zotero has synced to the cloud. Sarmate shows the reference count per collection to help you choose.
Citation auto-completion does not appear
Check that your document includes
\addbibresource{...} (or \bibliography{...}) pointing to the right file, then type \autocite{: the opening brace triggers the suggestions.
The API key does not work
Create a new one (“Create new private key”), copy it immediately (shown only once), and check it has at least read access.
Ready to cite?
Open your space, link a .bib file to Zotero and compile your document.