Translations of this page:

Troubleshooting Issues with Zotero Translators

Before you post that a translator is not working, try these steps:

  1. If you don't see an icon at all, make sure you're looking at a supported site. If you're not sure, try a New York Times article or an Amazon product page.
  2. Check Known Translator Issues to see if problems have been noted on the site you're trying to save from.
  3. Check your Zotero version to make sure you have the latest version available from zotero.org. While Zotero 3.0 is still receiving updated translators, we will only troubleshoot translators that also fail for the current 4.0 version of Zotero.
  4. [Zotero for Firefox only] Make sure you have an up-to-date version of Firefox. This can be either the latest available stable version (Zotero does not always work with beta, alpha, or nightly versions) or the latest Extended Support Release version (currently 17.0.x).
  5. Make sure you have the latest available translators by clicking “Update now” in the General tab of the Zotero preferences. If the button displays “Updated”, reload the page that was failing and try saving again. If the button displays “Up to date”, you already had the latest available translators. (Zotero automatically checks for updated translators every 24 hours, so this generally isn't necessary unless you know that the translator has just been updated.)
  6. If you see a Zotero icon in the browser address bar when viewing a supported web page, hover your cursor over the icon. The tooltip shows which translator Zotero will use for the site you are viewing. If the displayed translator is incorrect, post the site name, a URL, and the name of the incorrectly detected translator to the Zotero forums. Note that “Embedded Metadata,” “DOI,” and “COinS” are generic translators, and Zotero will not be able to save automatically from all sites on which it appears. Also PDFs will usually not be saved automatically on such pages.
  7. [Zotero for Firefox only] Make sure that Firefox Privacy settings (Options → Privacy) are not blocking cookies. Under history, you should not have “Firefox will:” set to “Never remember history”. You should also not have it set to “Use custom settings for history” and have “Accept cookies from sites” unchecked. It's also possible that some websites require “Accept third-party cookies” to be enabled.
  8. Make sure your system clock is set to the correct time and time zone.
  9. [Zotero for Firefox only] If you are having chronic problems getting Zotero to work across multiple sites, you may have an extension conflict. First, check if you have any Incompatible Extensions installed. If not, try disabling all Firefox add-ons except Zotero. To do this, open the Tools menu (or the main Firefox menu in Windows 7), click “Add-ons”, and then go to the “Extensions” tab. Click “Disable” for every add-on, and then restart Firefox. If this solves the problem, re-enable the add-ons one-by-one until you find the conflict, and then post the name of the add-on that was causing the issue to the forums.
  10. If you don't see the address bar icon on any supported sites (Amazon, NYTimes), there may have been a problem loading translators. If you received an unresponsive script warning related to Zotero while starting Zotero Standalone or Firefox and clicked “Stop Script”, restart Standalone/Firefox. If you receive the message again, click “Continue”.
  11. In rare cases where the address bar icon isn't appearing on any sites or saving is failing on all sites where the icon appears, there may be a problem with your translators directory. (This is extremely unlikely unless you've edited translators yourself or have your Zotero data directory stored in a service such as Dropbox, which is strongly discouraged.) Select “Reset Translators” from the Advanced pane of the preferences or manually delete the 'translators' directory from your Zotero data directory and restart Standalone/Firefox.
  12. If none of these solutions solve your problem, please make a new thread in the Site Translators category (or use an existing thread if you've already created one) and provide the URL of a page that isn't working (even if none are), a Report ID from after attempting to save (if you're trying to save from Chrome or Safari, follow the browser-specific Report ID instructions rather than the instructions for Zotero Standalone), and any other relevant information (operating system, browser and version, Zotero version, etc.). Please mention if you are using Zotero for Firefox or Zotero Standalone and a connector when reporting a translator issue.
troubleshooting_translator_issues.txt · Last modified: 2013/05/03 14:18 by aurimas