Zotero 5.0 and Firefox: Frequently Asked Questions

In A Unified Zotero Experience, we explained the changes introduced in Zotero 5.0 that affect Zotero for Firefox users. See that post for a full explanation of the change, and read on for some additional answers.

What’s changing?

Zotero 5.0 is available only as a standalone program, and Zotero 4.0 for Firefox is being replaced by a Zotero Connector for Firefox that allows you to save to Zotero as you browse the web, similar to the Chrome and Safari extensions that have been available for years for use with Zotero Standalone.

Why is this happening?

Mozilla is discontinuing the powerful extension framework on which Zotero for Firefox is based in favor of a new, more limited extension framework, and it’s no longer technically possible to create a tool like Zotero for Firefox within the browser.

Will you change your minds?

See above.

Won’t this ruin everything that’s great about Zotero?

We don’t think so. Zotero has been available as standalone version since 2011, and many people have preferred it over the Firefox version — and we’re now able to focus on making it better for everyone, without making compromises to fit everything into a tiny pane or spending time keeping up with constant Firefox changes. The Zotero Connector still provides powerful browser integration and an unmatched ability to save as you browse the web.

In recent months, we’ve made numerous improvements to the Zotero Connector to bring it in line with Zotero for Firefox’s browsing-related features, and the Connector already offers some functionality that Zotero for Firefox never did, with more on the way. Since the Connector works in Firefox, Chrome, and Safari, you can use Zotero with whichever browser you prefer, or even multiple browsers at the same time.

OK, if I’m running Zotero for Firefox, what do I have to do?

First, install the Zotero Connector for Firefox from the download page, which will replace Zotero 4.0 for Firefox. Next, from the same page, install Zotero 5.0 for Mac, Windows, or Linux.

You can also install the Zotero Connector in any other browsers that you use.

If I already have the Zotero Connector for Firefox, what do I have to do?

Make sure you’ve also installed Zotero 5.0 from the download page, and leave it open while you browse the web so you can save directly to it.

If I’m running Zotero Standalone 4.0, what do I have to do?

You can upgrade to Zotero 5.0 via Help -> Check for Updates from within Zotero, or you can reinstall Zotero from the download page.

If you’re also running Zotero 4.0 for Firefox, you should first install the Zotero Connector from the download page and restart Firefox.

If you’re using the Zotero Connector for Chrome, you don’t have to do anything else.

If you’re using the Zotero Connector for Safari, check for updates from the Extensions pane — you should have 5.0.23 or later. You can reinstall the Connector from the download page if you have an older version and an update isn’t showing up.

Will I lose my data?

No. Zotero 5.0 will automatically detect and upgrade your existing data. If your Zotero data directory is located within your Firefox or Zotero profile directory, it will be automatically moved to a “Zotero” directory in your home directory, where it won’t be affected by refreshing or uninstalling Firefox.

Where did the Z button in the Firefox toolbar go? How can I open Zotero without it?

Instead of clicking a Z button in the Firefox toolbar, you now switch to Zotero as you would any other program. (See Switching Between Programs for tips on doing this efficiently. Short version: Use the dock/taskbar/launcher or Cmd-Tab/Alt-Tab. Don’t waste time minimizing or moving windows to access what’s behind.)

You can also arrange your windows so that Zotero is visible while you’re browsing.

What about the “Save to Zotero” button?

The button still exists in the browser toolbar, and, as before, it will show you an icon representing the data Zotero detected on the page: webpage, journal article, newspaper article, etc.

If you don’t see the icon, check your browser’s extensions pane to make sure you have the Zotero Connector installed. In some cases, the button may appear in the overflow panel accessible from the right edge of the toolbar.

How can I choose what collection to save to?

Just as in Zotero for Firefox, select the desired target collection in Zotero before clicking the save button. See Switching Between Programs for tips on accessing Zotero quickly.

An upcoming Zotero Connector version will provide the ability to choose the target collection from within the browser itself.

Are there any features that are no longer available?

While we’ve worked to make all browsing-related functionality available via the Zotero Connector, a few features either haven’t yet been migrated over or aren’t possible in the new Firefox extension framework.

Planned, but not yet available:

  • “Attach Snapshot of Current Page” (snapshots are still available when saving new items)
  • “Create Zotero Item and Note from Selection”/“Add Selection to Zotero Note”
  • “Save Link As Zotero Item”

No longer possible:

  • “Save to Zotero” option in the Firefox open/save dialog — workarounds: find the article page instead and use the “Save to Zotero” button to download the metadata and PDF automatically (recommended whenever possible); preview the PDF in Firefox and click the “Save to Zotero” button; drag the PDF link to Zotero; save the PDF to disk and drag into Zotero; add Zotero as PDF handler in Firefox and choose it from the open/save dialog (not currently possible, but planned)

What if I can’t install separate programs like Zotero at my institution?

Zotero can be installed without administrative privileges on most systems. You can also ask your IT department to install it for you.

It’s worth noting that the Firefox extension framework used by Zotero for Firefox for many years granted equivalent system access, so from a security standpoint there’s no difference between the previous Firefox extension and the standalone program. If anything, the standalone program is more secure, as the Zotero Connector code running within your browser is limited by Mozilla’s new WebExtension framework.

If you really can’t install separate programs, you can still use the Zotero Connector in your browser and save directly to your online library, but you’ll need to rely on the more limited web interface for managing your data. (Improvements to the web library are planned, but the desktop client will remain the recommended way of interacting with your Zotero data.)

What if I used multiple Firefox profiles to keep my Zotero data separate?

Zotero 5.0 supports the same profile system as Firefox. See Multiple Profiles for more info.

What if I’m using Zotero plugins that haven’t yet been updated for Zotero 5.0?

Most plugins have been updated, at least in beta form, so first check with the plugin author.

If a plugin you rely on hasn’t been updated, you can use the Zotero Connector for Firefox with Zotero Standalone 4.0, which is still available from the download page, for a while longer. Install the plugin from the Tools -> Add-ons -> Extensions pane in Zotero. Some Connector features may not work properly with Zotero 4.0, but you should still be able to save items to Zotero from the Connector.

How much longer can I use Zotero 4.0 for Firefox?

Zotero 4.0 for Firefox will cease to work in Firefox 57, which will be released on November 14, 2017, and existing Zotero for Firefox users will be upgraded to the Zotero Connector shortly before then. If you need to use Zotero 4.0 for Firefox for longer, you should switch to the Firefox 52 Extended Support Release, which will be supported by Mozilla until June 2018, and disable updates for the Zotero extension by clicking “More…” next to Zotero in the Firefox Add-ons pane. (Remember to re-enable updates when you later switch to the Zotero Connector.) If you’re already running the Zotero Connector, you can reinstall Zotero 4.0 for Firefox from the download page. Note that Zotero 4.0 syncing will cease to work in early 2018.

To benefit from the many improvements in Zotero 5.0, and to obtain support in the Zotero Forums, we recommend upgrading as soon as possible.

New Features for Chrome and Safari Connectors

We are excited to announce major improvements to the Zotero Connectors for Chrome and Safari.

Chrome

The Zotero Connector for Chrome now includes functionality that was previously available only in Zotero for Firefox.

Automatic Institutional Proxy Detection

Many institutions provide a way to access electronic resources while you are off-campus by signing in to a web-based proxy system. The Zotero Connector for Chrome makes this more convenient by automatically detecting your institutional proxy. Once you’ve accessed a site through the proxy, the connector will automatically redirect future requests to that site through the proxy (e.g., if you open a link to jstor.org, you’ll be automatically redirected to jstor.org.proxy.my-university.edu).

Notification bar at top of webpage: Zotero detected that you are accessing www.jstor.org through a proxy. Would you like to automatically redirect future requests to www.jstor.org through proxy.my-university.edu?

Proxy detection does not require manual configuration. You can disable or customize it from the connector preferences.

Style Installation and Automatic File Importing

Zotero for Firefox has long included support for installing citation styles and importing reference manager files such as BibTeX or RIS when opened in Firefox. This functionality is now supported by the Zotero Connector for Chrome.

Dialog box: Add citation style to Zotero?

Clicking on a link to a CSL file will display a prompt to install the style into Zotero. Clicking on a BibTeX or RIS file that is served correctly by the website will prompt to import its data into Zotero. If you choose ‘Cancel’, you can download the file normally.

Note that this feature requires Zotero 5.0.

Upgrading

If you have the latest version of Chrome installed, you should be automatically updated to version 5.0.5 or later of the Zotero Connector. If you’re not currently using Zotero with Chrome, you can install the extension from the downloads page. Make sure you’ve installed Zotero 5.0 as well for the best experience.

Safari

We’ve brought several features to Safari that were previously available only in Chrome and Firefox.

Streamlined Saving

Previously, on pages where Zotero could not detect any high-quality data, the Zotero save button was inactive, and you could save a basic webpage item and snapshot by right-clicking on the page and selecting “Save Page to Zotero”. In the latest version of the Zotero Connector for Safari, it’s possible to save any page to Zotero with the click of a button.

Tooltip when hovering over save button that says 'Save to Zotero (Web Page with Snapshot)'

When high-quality data is available, the button will show the same icon as before: book, newspaper, etc. On all other pages, you’ll see an empty page icon, and clicking on it will create a basic webpage item and snapshot in Zotero. Hovering over the icon will tell you which translator, if any, Zotero would use to save the page.

One-click PDF saving

You can also now save PDFs to Zotero with a single click.

Tooltip when hovering over save button that says 'Save to Zotero (PDF)'

Previously, saving a PDF to Zotero from Safari required dragging from the address bar into Zotero or saving the PDF to disk and adding it to Zotero manually. Now, when you’re viewing a PDF in Safari, simply click the toolbar button to save the PDF as a top-level attachment in Zotero, after which you can use “Retrieve Metadata from PDF” or “Create Parent Item” to create a full bibliographic item. Note that, when possible, it’s still preferable to save from a webpage with full metadata.

Secondary Translators

On some webpages, Zotero can save data using multiple translators, but up until now it hasn’t been possible to choose a secondary translator from Safari. You can now long-press the Zotero button to see additional options for saving from the current page, including saving as a regular webpage instead of using a translator.

Save button context menu with option to save to Zotero using COinS on Wikipedia page

Secondary translators may provide different data for the page itself or data for other sources referenced in the page (for example, cited references on Wikipedia, as in the example above).

Upgrading

You can get the new version of the Safari extension from the downloads page or by updating to 5.0.0 or later from the Extensions pane of the Safari preferences. Make sure you’ve installed Zotero 5.0 as well for the best experience.

A Unified Zotero Experience

Since the introduction of Zotero Standalone in 2011, Zotero users have had two versions to choose from: the original Firefox extension, Zotero for Firefox, which provides deep integration into the Firefox user interface, and Zotero Standalone, which runs as a separate program and can be used with any browser.

Starting with the release of Zotero 5.0, Zotero for Firefox and Zotero Standalone have been replaced by a single standalone application for users of all browsers. A new Zotero Connector for Firefox, similar to the extensions available for Chrome and Safari, allows saving to the Zotero application or zotero.org in a single click.

the Firefox toolbar on an Amazon webpage showing a book icon and a tooltip saying Save to Zotero (Amazon)
Saving to Zotero from the Zotero Connector for Firefox

If you’re using Zotero for Firefox, you’ll soon be upgraded to the new Zotero Connector for Firefox, which provides the same “Save to Zotero” button in the Firefox toolbar that you’re used to. You’ll then need to install the standalone Zotero application to access your data. Going forward, instead of clicking a “Z” button in the Firefox toolbar, you’ll open Zotero like any other program on your computer. The Zotero application offers the same interface and runs off the same database as Zotero for Firefox, so you’ll be able to pick up right where you left off.

If you’re already using Zotero Standalone, you can continue using Zotero as you were before — with some new features available in the Zotero Connector for your browser.

Why is this happening?

The reason for this change is technical, and, unfortunately, out of our control: Mozilla is discontinuing the powerful extension framework on which Zotero for Firefox is based in favor of WebExtensions, a new framework based on the Chrome extension model. WebExtensions offer many advantages, including improved browser performance, improved security, a fine-grained permissions model, and the ability to create a single extension that runs in both Chrome and Firefox (as we’ve done with the Zotero Connector). The trade-off is that it’s no longer possible to create an extension like Zotero for Firefox that affects the browser in more profound ways (adding an entirely new pane or tab, creating native-looking windows, adding options to the open/save dialog, etc.) or that uses low-level features of Firefox to manage a database, access the filesystem, or run local programs.

But while we’re not able to continue offering the full version of Zotero for Firefox, we think that this change will ultimately benefit the Zotero ecosystem going forward. The Zotero interface will no longer need to fit into a small browser pane, allowing for a much richer user experience. Offering a single version will mean that documentation and instruction can be greatly simplified. And most importantly, Zotero developers will be able to spend less time maintaining separate versions and responding to Firefox changes and more time improving Zotero for everyone.

In the lead-up to Zotero 5.0, we’ve worked hard to add features that were previously available only in Zotero for Firefox, such as institutional proxy support, to the existing Chrome and Safari connectors and the new Zotero Connector for Firefox. Those changes are documented in a separate post. As Mozilla and Chrome add additional capabilities to their extension frameworks, we’ll continue to add new features to the connectors.

When we launched Zotero a little over 10 years ago, the Firefox extension framework allowed us to create a new type of research tool that lived where people worked, in the browser itself. Today, we think we can offer the best of both worlds — unparalleled extensions for every browser, all connecting to a powerful standalone app. While it’s tough to say goodbye to the original version of Zotero, we couldn’t be more excited about Zotero’s future, beginning with Zotero 5.0. Here’s to the next 10 years.

Other questions? Check out the FAQ for additional details.

Zotero 5.0

We’re delighted to announce the release of Zotero 5.0, the next major version of Zotero and the biggest upgrade in Zotero’s history. Zotero 5.0 brings many new features, as well as a huge number of changes under the hood to improve Zotero’s responsiveness and stability and lay the groundwork for other big developments coming soon. We’ll be highlighting some of the new features in upcoming posts, but for now see the changelog for more details on all that’s new.

Download Zotero 5.0 now to get started with the new version.

If you’re already using Zotero Standalone 4.0, you’ll be offered the choice to upgrade soon, or you can update now via Help -> Check for Updates. (Windows users may wish to reinstall from the download page instead to rename the program from “Zotero Standalone” to “Zotero”.) Your database will be automatically upgraded to work with the new version.

If you’re using Zotero 4.0 for Firefox, be aware that Zotero 5.0 now runs only as a standalone application, and a new Zotero Connector for Firefox replaces the full Firefox extension. We’ve written a separate post explaining this change. Existing Zotero for Firefox users will soon be upgraded to Zotero Connector for Firefox and will need to install Zotero 5.0 to continue accessing their Zotero data locally. If you install Zotero 5.0 now, be sure to install the Zotero Connector for Firefox from the download page as well.

Thanks to everyone from the Zotero community who has helped test Zotero 5.0 over the last year and get it ready for today. We’re excited to finally share it with the world!

Indiana University Survey of Zotero Users

As part of a grant funded by the Alfred P. Sloan Foundation to analyze altmetrics and expand the Zotero API, our research partners at Indiana University are studying the readership of reference sources across a range of platforms. Cassidy Sugimoto and a team of researchers at IU have developed an anonymous, voluntary survey that seeks to analyze the bibliometrics of Zotero data. The survey includes questions regarding user behavior, discoverability, networking, the research process, open access, open source software, scholarly communication, and user privacy. It is a relatively short survey and your input is greatly appreciated. We will post a follow-up to the Zotero blog that analyzes the results of the survey. Follow this link to take the survey.