We’re in the process of updating the documentation for Zotero 5.0. Some documentation may be outdated in the meantime. Thanks for your understanding.
This page describes some of the reported issues with the Word and OpenOffice/NeoOffice word processor plugins for Zotero 1.0, together with possible solutions.
If you are using Zotero 2.0, see the main troubleshooting page.
"An error occurred communicating with Zotero"
You may receive the following message when attempting to use the word processor plugins:
“An error occurred communicating with Zotero. Please ensure Firefox is open and try again.”
There are a number of possible causes for this error. Make sure you are running the latest version of Zotero, and then review the following steps in order:
If you can insert a citation into a new, empty document but receive a communication error in an existing document:
- Verify that you have the CSL style file used by the document installed.
If you receive a communication error when attempting to insert a citation into a new, empty document:
- Make sure Firefox is running and Work Offline mode is not checked in the File menu. You do not need to be online to use Zotero word processor integration, but Firefox's Work Offline mode cannot be enabled.
- Check if you get the error using a different bibliography style.
- Make sure the Track Changes feature is disabled in Word/OpenOffice, as it is known to cause problems with Zotero integration.
- If you are using Microsoft Word on Windows, open Internet Explorer and make sure Work Offline is not enabled under the File menu. Word's connection to Zotero is dependent on the Windows/IE network settings.
- If you are using OpenOffice, make sure the plugin and the required Python components are correctly installed and enabled.
- Ensure that Zotero and all subcomponents are enabled in the Extension Manager.
- Linux users may need to install the openoffice.org-pyuno (or equivalent) package if their distribution doesn't install it by default.
- If the PYTHONPATH environment variable is set by another application, you may need to remove it.
- Start Zotero with debug output enabled and look for a message in the first 15-20 lines that includes the phrase “integration HTTP server”.
- If you see the message “Not initializing integration HTTP server”:
- Make sure other copies of Firefox/Zotero aren't running on your system (including in other user accounts or in hidden processes). Restarting the computer might help. Advanced users on OS X and Linux could use the netstat tool from a terminal window to check if other applications are bound to port 50001.
- If you see the message “Integration HTTP server listening on 127.0.0.1:50001”:
- Disable any firewall software running on your computer. If this fixes the problem, make sure your firewall is set to allow access to “localhost” or “127.0.0.1” (also known as the “loopback interface”).
- If you don't have or have disabled firewall software, check your computer's proxy settings.
- On Windows XP, open Internet Explorer, go to Tools→Internet Options→Connections→LAN Settings, and disable “Automatically detect settings” and “Use a proxy server for your LAN”. If this fixes the problem, you will need to keep “Automatically detect settings” off and make sure “Bypass proxy server for local addresses” is checked.
- Still having trouble? Search the Zotero forums. There are many threads on communication errors in Word and OpenOffice and communication errors in OpenOffice specifically. If posting a new message, please include the following information:
- Operating system
- Firefox version
- Zotero version
- Word processor (Word or OpenOffice) and version
- Zotero word processor plugin version
- Whether the integration server was listed as running in the debug output
Run-time error '91'
This is a generic error with many potential causes. It is often caused by problems with proxy servers or other network settings.
- Open Internet Explorer, go to Tools→Internet Options→Connections→LAN Settings, and disable “Automatically detect settings”. This is known to fix the problem for Shaw Cable users in Canada and may help with other ISPs as well.
- See the relevant forum thread for further discussion.
One user also reported that deleting Normal.dot from Word fixed the error.
"BASIC execution error, property or method not found"
This has been reported in OpenOffice if a citation is inserted inside a frame.
Word Processor Freezing
Some users have experienced freezes when attempting to insert citations.
- Make sure more than one Zotero-enabled Firefox isn't running on your computer.
- If you use multiple user accounts on your computer, plugin windows may appear in other user accounts. You will need to always close Firefox before switching users or use a different integration port on each account.
Other solutions that people have found:
- Disable Java runtime in OpenOffice
- Upgrade to OpenOffice 3.1 or later