How To Use Zotero INSIDE Roam Research

Zotero can be wired directly into Roam Research so that every citation in a Zotero library—authors, titles, publication details, tags, and automatically generated site keys—appears inside Roam exactly when writing needs it. The payoff is practical: Roam pages get populated with metadata on demand, and site keys can be copied into Roam text to later produce properly formatted references without manual re-entry.

The setup starts inside a Roam graph by adding a JavaScript “Zotero integration” block. That block pulls in an extension script (sourced from the extension’s documentation) and requires three key inputs: a Zotero API key, a Zotero user ID embedded into a “data URI,” and an optional params field. Leaving params empty is the crucial choice—it instructs the integration to fetch the entire Zotero library rather than a filtered subset. The extension also needs a “private key” generated in Roam so the integration can authenticate to the graph.

Getting the Zotero API key and user ID comes from Zotero itself. After logging into Zotero online, the user ID is found under the account’s Settings → Feeds API page, then copied into the Roam integration’s data URI field. The API key is created from the same feeds interface via a new saved key; it should be treated as secret because anyone with it can read the associated library data. The transcript emphasizes that the integration is read-only by default—permissions can be limited to reading, with no write access to the Zotero library.

A major dependency is site keys. The integration relies on Better BibTeX’s “auto pinning” so each Zotero item gets a stable, memorable site key that can be transported to Zotero online and then retrieved by Roam. That requires installing Better BibTeX in Zotero, then enabling Zotero’s Advanced Config Editor setting for auto pin extension and setting an auto pin delay (e.g., a few seconds). If a site key isn’t generated as desired, the workflow includes unpinning and repinning the Better BibTeX key for that item until the site key is correct.

Once the JavaScript integration is enabled in Roam (via the “I know what I’m doing” confirmation), a book icon appears. Clicking it downloads the Zotero library metadata into the Roam graph background; the integration turns green when the data is ready, and the data must be refreshed after reloading Roam.

Using it is centered on two Roam shortcuts: a search panel and a quick copy panel. On macOS and some international keyboard layouts, the transcript notes that “Alt + P” may register differently, so the shortcut configuration may need adjustment (e.g., entering “pi” instead of “p,” and handling special characters like “c” with a tail). With the search panel, users can find a paper by title/author, import metadata into a Roam page, and open the local Zotero entry or PDF with one click. Quick copy lets users retrieve a site key directly while writing, enabling Roam to format references later.

Finally, there’s room for customization: metadata can be mapped differently in Roam—for example, placing publication names on their own pages to group papers by journal. The transcript points to additional documentation, a help/community page, and a follow-up blog post for deeper control over how metadata lands in the graph.