Plugins

Zotero Plugin Template

by windingwind · github.com/windingwind/zotero-plugin-template

A starter template for building Zotero plugins in TypeScript.

Zotero Plugin Template has a Zotero Plugins grade of B (use with care) because a zotero:// link (a web page can open one) can make it install add-ons without asking you (from zotero-plugin-toolkit), and 1 more finding. It works with Zotero 7, not the current Zotero 10. Last checked 15 Nov 2026.

View source
Downloads a .xpi file (0.04 MB). In Zotero, open Tools → Plugins and install it from the file.
In useAn estimate of how many copies of Zotero have it: Zotero downloads each new version once for every copy that has the plugin, so we count the downloads of its most-downloaded recent release. Rounded. Plugins that update from outside GitHub count low.
2.2k
DownloadsAll-time downloads of its release files from GitHub, counting every update. Installs from elsewhere aren't counted.
11,422
Latest releaseDownloads of version 3.1.0, its latest release, since it came out on 29 Mar 2025. A new release starts from zero; Downloads counts every release.
2,173
ReleasesVersions published on GitHub. Everyone who has the plugin downloads each one again, which adds up in Downloads.
36
AgeTime since its GitHub repository was created, on 19 Aug 2022. The plugin can be younger than its repository.
4 years
StarsPeople who starred the repository on GitHub: a rough measure of interest.
855
ContributorsPeople who have committed code to this plugin. Bots don't count, nor do the authors of a template or project it was copied from.
5
LicenceThe licence the code is published under, as GitHub reports it.
AGPL-3.0
B
Zotero Plugins gradeUse with care
because a zotero:// link (a web page can open one) can make it install add-ons without asking you (from zotero-plugin-toolkit), and 1 more finding
Applies to v3.1.0, released 29 Mar 2025Code checked · not yet tested in a live Zotero
Doesn't work with the current Zotero (10)Works with Zotero 7.
Another plugin uses the same ID4 other plugins share this add-on ID. Zotero can only install one of them.
What we found in the codeSets the gradeThe worst finding in these three areas sets the grade.
Code transparencyReadable code, uploaded by the project's automated GitHub buildThe release file was uploaded by the project's automated GitHub build. We haven't yet rebuilt it from the source to compare.LowLow concern: normal for plugins that do this job. Listed so you know.
Updates
Updates come from this project's GitHub repositoryThe update address offers this version
Where your data goesNo web requests foundLowLow concern: normal for plugins that do this job. Listed so you know.
No further detail for this area yet.
Powerful capabilitiesA zotero:// link (a web page can open one) can make it install add-ons without asking you, and 1 moreMediumMedium concern: worth reading before you install. One medium finding makes the grade B.
Medium concern (2)
A zotero:// link (a web page can open one) can make it install add-ons without asking you (from zotero-plugin-toolkit)A zotero:// link can make it run code if you approve a prompt (from zotero-plugin-toolkit)
Where we found it
A zotero:// link (a web page can open one) can make it install add-o…content/scripts/addontemplate.js · line 154

zotero://plugin. zotero-plugin-toolkit removed this link in version 6.0.0; this plugin is built with an older version

Services.io.getProtocolHandler("zotero").wrappedJSObject._extensions["zotero://plugin"] = pluginBridgeExtension;
A zotero:// link can make it run code if you approve a promptcontent/scripts/addontemplate.js · line 100

zotero://ztoolkit-debug

Services.io.getProtocolHandler("zotero").wrappedJSObject._extensions["zotero://ztoolkit-debug"] = debugBridgeExtension;
Before you installShown, not gradedFacts to help you decide. They don't change the grade.
Works withZotero 7 · not 9, 10Doesn't work with the current Zotero (10)MediumMedium concern: worth reading before you install. One medium finding makes the grade B.
Zotero 7 ✓ worksZotero 9 ✗ doesn't workZotero 10 ✗ doesn't workZotero 11 beta not tested yet: Zotero hasn't opened Zotero 11 testing
What you'll needZotero 7Detected automatically from its code
No further detail for this area yet.
MaintenanceActive · last release 29 Mar 20255 contributors
No further detail for this area yet.
LanguagesDocumentation in EnglishInterface: English and Chinese
No further detail for this area yet.
We report what we found in the code. Open any area for the evidence.How we gradeReport a problem

What it does

Written by AI from the README

A starter template for building Zotero plugins in TypeScript. Includes examples of menus, columns, preference panes, shortcuts and dialogs, plus build, hot reload and release automation.

For plugin developers who want a working skeleton instead of building one from scratch. It adds nothing to Zotero by itself.

What you'll need

Detected automatically
  • Zotero 7Not working with Zotero 10

Where your data goes

We found: no web requests found.

Forks and copies

4 other plugins use the same ID as this one. Every Zotero plugin carries an ID, a name tag Zotero uses to tell plugins apart. Developers often start from a ready-made template, which comes with a placeholder ID. These plugins never replaced it, so they have nothing in common except that ID.Show what this means
  • You can only have one. Zotero sees them as the same plugin.
  • Installing another replaces it. If you install one of the others, it takes this one's place.
  • They do different things. The one you install may have nothing to do with the one it replaces.
Zotero Plugin Template · this pluginwindingwind/zotero-plugin-templateBUse with care11,42229 Mar 2025
zotero export pdfguokelei1/zotero-export-pdfBUse with care30627 Feb 2026
zotero-plugin-testnorthword/zotero-plugin-testBUse with care303 Feb 2025
ipec-paper-groupDelinQu/ipec-paper-groupBUse with care1810 Oct 2025
See all 5 and how they differ →

9 listed forks.

The developer's response

The developer hasn't responded. Developers can reply here, and their reply sits next to our findings.I'm the developer

Ratings and reviews

What people who use it say. This is separate from the grade, which is what the code does, and never changes it.

No ratings yet.

Write a review
Your rating of Zotero Plugin Template v3.1.0

Your review is public, under the name you give, and published with the directory's data under CC BY 4.0. Links are removed. We never store your IP address: a scrambled code made from it is kept for 30 days to catch fake reviews. Every review is checked before it's published; how fake ones are spotted isn't published, so it can't be gamed.

Install Zotero Plugin Template
BUse with care
Before you install: A zotero:// link (a web page can open one) can make it install add-ons without asking you (from zotero-plugin-toolkit), and 1 more finding.Read the finding