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

Install ZotLit Companion

Install the ZotLit Companion add-on in Zotero.

ZotLit Companion, the Zotero add-on, keeps recent Zotero changes available to ZotLit and adds ZotLit actions to Zotero's menus. ZotLit browses and reads your library without it. To decide whether you need it, read Keep Zotero and Obsidian in sync.

Install the add-on

Stable2.2.2 · 2026年11月9日
RequiresZotero 9.0 – 10.x

Download the .xpi file

Download the latest Companion file directly:

Download the .xpizotlit-zotero-2.2.2.xpi

If you are using Firefox, you should right click the link and choose Save Link As...

To select a file manually, find the latest Companion release on the ZotLit releases page. Its filename starts with zt-.

Install in Zotero

In Zotero, open Tools > Add-ons. Click the gear menu and select Install Add-on From File.... Choose the .xpi file you downloaded, then confirm when prompted.

Confirm the installation

After installing, a ZotLit pane should appear in Zotero's settings.

In Obsidian, the welcome checklist above the Library View automatically detects the installation and marks 安装 ZotLit Companion as 已安装.

You do not need to configure anything here right now. The next section explains when this matters.

Keep the database file current

The Companion enables 为 Obsidian 保持数据库文件最新 by default. This setting lets ZotLit read recent Zotero changes when you update a literature note. Keep it enabled under the 数据库 section of the ZotLit pane.

This database setting works without live updates. Basic context-menu actions also work through protocol links with no extra setup.

About live updates

Live updates push changes from your Zotero library to Obsidian. They require the Companion's notification setting and the ZotLit server in Obsidian.

Live updates are optional. The Companion keeps the database file current even when live updates are disabled.

The setup for live updates is covered in Set up live updates.

Next steps

If you have not yet, follow the tutorial to open your library and create your first literature note.

Last updated on

On this page