 
====== Zotero Connector and Safari ======

===== Installation =====

The Zotero Connector for Safari is bundled with the Zotero desktop app. (Unlike other browsers, Safari does not allow direct installation of browser extensions.) After opening Zotero for the first time, you can enable the Zotero Connector from the Extensions pane of the Safari settings ("Safari" menu → "Settings" → "Extensions", **not** "Safari" menu → "Safari Extensions…").

The Zotero Connector for Safari requires macOS 11 Big Sur or later.

Using an iPhone or iPad? You can save to the [[https://apps.apple.com/us/app/zotero/id1513554812|Zotero iOS app]] using the Share sheet in Safari and other browsers.

{{:kb:safari-compatibility.png?width=700}}

<HTML><p id="can_t_see_the_save_button_save_button_flickering"></p></HTML>

===== Extension not showing up? Save button missing or flickering? =====

A macOS bug can cause the Zotero Connector to disappear from Safari or stop working after the Zotero app is updated.

If you find that the extension isn't listed in the Safari settings or the toolbar button isn't appearing or working properly, you can likely fix it using one of the options below. Your data will not be affected.

Currently, the only known way to avoid this problem altogether is to switch to a browser with a more reliable extension framework such as Firefox, Chrome, or Edge.

==== Fix 1: Delete and Reinstall Zotero ====

  - Delete the Zotero app from Applications
  - Redownload it from the [[/download|download page]]
  - Start Zotero

It may also help to restart your computer in between deleting the app and restoring it, though this isn't usually necessary.

==== Fix 2: Compress and Uncompress Zotero ====

This option avoids redownloading the app.

  - In Finder, go to the Applications folder and compress the Zotero app (right-click → Compress “Zotero”)
  - Delete the app
  - Double-click the ZIP file
  - Delete Zotero.zip
  - Start Zotero

==== Fix 3: Force Extension Reloading (advanced) ====

  - Go to Safari → Settings → Advanced
  - Enable "Show features for web developers" at the bottom
  - Click the new Developer tab that appears and toggle "Allow Unsigned Extensions" on and off. The Zotero Connector is signed, so it is not necessary to leave "Allow Unsigned Extensions" enabled.

===== Limitations =====

Due to technical limitations of the Safari extension framework, some features available in Firefox, Chrome, and Edge aren't available in Safari:

  * Automatic proxy redirection
  * Automatic RIS/BibTeX import
  * Automatic CSL installation

Other differences:

  * Gated PDFs may not be saved on some sites (e.g., ScienceDirect)
  * It's not possible to right-click on the toolbar button to access secondary translators. Instead, right-click on the page itself.

{{tag>kb basics}}