| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| word_processor_plugin_troubleshooting [2024/08/18 05:35] – [Error or non-responsive plugin buttons] dstillman | word_processor_plugin_troubleshooting [2025/02/20 04:06] (current) – [Mac] dstillman |
|---|
| ==== Windows ==== | ==== Windows ==== |
| |
| ==== Error or non-responsive plugin buttons==== | === Error or non-responsive plugin buttons=== |
| |
| * //"Zotero experienced an error updating your document."// | * //"Zotero experienced an error updating your document."// |
| |
| - Restart your computer. Start Zotero before starting Word. | - Restart your computer. Start Zotero before starting Word. |
| - If the plugin still isn't working in Word, go to your [[word_processor_plugin_manual_installation#locating_your_word_startup_folder|Word Startup folder]], delete Zotero.dotm, and restart Word to make sure that the plugin is completely gone from Word. Then [[#zotero_toolbar_doesn_t_appear|reinstall the plugin]]. | - If the plugin still isn't working in Word, go to your [[word_processor_plugin_manual_installation#locating_your_word_startup_folder|Word Startup folder]], delete Zotero.dotm, and restart Word to make sure that the plugin is completely gone from Word. (If the "Zotero" tab isn't disappearing, see the steps in the linked section.) Once the "Zotero" tab is gone from Word, [[#zotero_toolbar_doesn_t_appear|reinstall the plugin]]. |
| - Make sure you [[kb/could_not_find_a_running_word_instance|haven't disabled UAC]]. | |
| - Make sure that you're running Zotero as the same user as Word. Specifically, check to make sure neither program is running as administrator (right-click → Properties → Compatibility). For security and stability reasons, you should typically not run any software as administrator. | - Make sure that you're running Zotero as the same user as Word. Specifically, check to make sure neither program is running as administrator (right-click → Properties → Compatibility). For security and stability reasons, you should typically not run any software as administrator. |
| - Temporarily disable any security software you're running, which could interfere with the connection between Word and Zotero. | - Temporarily disable any security software you're running, which could interfere with the connection between Word and Zotero. |
| |
| |
| ===="This command is not available because no document is open"==== | ==="This command is not available because no document is open"=== |
| Zotero's Word add-on currently does not work for documents in OneDrive. Move your document to a different folder. Other cloud-syncing services such as Dropbox or Google Drive are not affected (note that Zotero documents should not be opened or edited in Google Drive's word proccessor as this [[#_citations_converted_to_plain_text|will break Zotero citations]]. See [[https://forums.zotero.org/discussion/41885/ms-word-2013-plugin-stopped-working-in-single-document/#Item_9|this thread]] for details and developments. | Zotero's Word add-on currently does not work for documents in OneDrive. Move your document to a different folder. Other cloud-syncing services such as Dropbox or Google Drive are not affected (note that Zotero documents should not be opened or edited in Google Drive's word proccessor as this [[#_citations_converted_to_plain_text|will break Zotero citations]]. See [[https://forums.zotero.org/discussion/41885/ms-word-2013-plugin-stopped-working-in-single-document/#Item_9|this thread]] for details and developments. |
| ==== Mac ==== | ==== Mac ==== |
| |
| First, make sure you've tried the [[#zotero_toolbar_doesn_t_appear|general troubleshooting steps]]. | First, make sure you've tried the [[#zotero_toolbar_doesn_t_appear|general troubleshooting steps]]. |
| |
| If you're still having trouble, check your [[https://support.office.com/en-us/article/about-office-what-version-of-office-am-i-using-932788b8-a3ce-44bf-bb09-e334518b8b19|specific Word version number]] and follow the appropriate steps below: | |
| |
| == Version 15.41 and higher == | |
| |
| Make sure you're running the latest stable version of Word. | Make sure you're running the latest stable version of Word. |
| |
| If Zotero.dotm still doesn't show up, you may not have correctly performed the [[word_processor_plugin_manual_installation|manual installation steps]] to copy Zotero.dotm to your current Word Startup folder. | If Zotero.dotm still doesn't show up, you may not have correctly performed the [[word_processor_plugin_manual_installation|manual installation steps]] to copy Zotero.dotm to your current Word Startup folder. |
| |
| == Version <15.41 == | |
| |
| Update Word to the latest stable version (15.41 or above). | |
| |
| === “Word could not communicate with Zotero. Please ensure that Zotero is open and try again.” === | === “Word could not communicate with Zotero. Please ensure that Zotero is open and try again.” === |
| First, make sure the Zotero app is open and running on your computer. Note that this is the Zotero program, not the Zotero website or Zotero Connector in your browser. | First, make sure the Zotero app is open and running on your computer. Note that this is the Zotero program, not the Zotero website or Zotero Connector in your browser. |
| |
| If Zotero is open and you're still receiving this error, there are two likely causes: | If Zotero is open and you're still receiving this error, you likely don't have the latest version of the Zotero plugin in Word. Go to your [[:word_processor_plugin_manual_installation#locating_your_word_startup_folder|Word Startup folder]], delete Zotero.dotm, restart Word, and confirm that the Zotero tab is gone from Word. If it doesn't disappear, follow the instructions for identifying your //active// Word Startup folder, delete Zotero.dotm from there as well, and reset your Word Startup folder location to the default to avoid future problems. Once the Zotero tab is gone from Word, follow the steps under [[#Zotero toolbar doesn't appear]]. |
| |
| - You don't have the latest version of the Zotero plugin in Word. Make sure you're running Zotero 6.0.28 or later or Zotero 7. If you're still getting the error, go to your [[:word_processor_plugin_manual_installation#locating_your_word_startup_folder|Word Startup folder]], delete Zotero.dotm, restart Word, and confirm that the Zotero tab is gone from Word. If it doesn't disappear, follow the instructions for identifying your //active// Word Startup folder, delete Zotero.dotm from there as well, and reset your Word Startup folder location to the default to avoid future problems. Once the Zotero tab is gone from Word, follow the steps under [[#Zotero toolbar doesn't appear]]. | If you modified your Zotero installation to work with multiple instances, you may need to do [[kb:multiple_instances#word|additional configuration]]. This does not apply to most users. |
| - You previously started Zotero from a disk image instead of dragging it to Applications first, or you have two copies of the Zotero app in different locations on your computer (e.g., a "Zotero" and "Zotero 2" in Applications). Close Zotero, open the [[kb:profile_directory|Zotero profile directory]], and delete extensions.json. Then restart Zotero. | |
| |
| If you continue to receive the error, you may have modified your Zotero installation to work with [[kb:multiple_instances|multiple instances]], in which case you need to do additional [[kb:multiple_instances#word|configuration for the Word for Mac Zotero plugin]]. | |
| === No response from plugin === | === No response from plugin === |
| |
| |
| - Restart Word and try again. | - Restart Word and try again. |
| - Close Word and go to Tools -> Add-ons -> Extensions in Zotero. Make sure Zotero Word for Mac Integration is listed and enabled. If it is disabled, enable it. If it is missing entirely, see [[#zotero_toolbar_doesn_t_appear|Zotero toolbar doesn't appear]]. After re-enabling/re-installing Zotero Word for Mac Integration, open the Cite -> Word Processors pane of Zotero preferences and click "Reinstall Microsoft Word Add-in" on the "Word Processors" tab. Restart Word and try again. | - If the plugin still isn't working in Word, go to your [[word_processor_plugin_manual_installation#locating_your_word_startup_folder|Word Startup folder]], delete Zotero.dotm, and restart Word to make sure that the plugin is completely gone from Word. Then [[#zotero_toolbar_doesn_t_appear|reinstall the plugin]]. |
| |
| | === Run-time error '5': Invalid procedure call or argument === |
| |
| | Some macOS audio plugins Voxengo SPAN or Voloco may interfere with the Zotero Word plugin. They can be found at ''~/Library/Audio/Plug-Ins/Components''. Try temporarily removing the plugins and test if the issue persists. |
| ==== Linux ==== | ==== Linux ==== |
| |
| //"Installation could not be completed because an error occurred."// | //"Installation could not be completed because an error occurred."// |
| |
| See [[:kb/word_processor_plugin_installation_error#libreoffice|Troubleshooting Errors with Word Processor Plugin Installation]] | See the [[:kb/word_processor_plugin_installation_error#libreoffice|installation troubleshooting instructions]]. |
| |
| |
| === Toolbar is missing === | === Toolbar is missing === |
| |
| Check if there's an entry for Zotero under View -> Toolbars. If not, look for the Zotero LibreOffice Integration plugin in Tools -> Extension Manager. If it's in not there, return to Zotero and the Cite pane of Zotero preferences. On the "Word Processors" tab, click the "Install LibreOffice Add-in" button. If you get an error, refer to [[#installation_error|installation troubleshooting instructions]]. | Check if there's an entry for Zotero under View → Toolbars. If not, look for the Zotero LibreOffice Integration plugin in Tools → Extension Manager. If it's in not there, return to Zotero and the Cite pane of the Zotero settings. In the "Word Processors" settings, click the "Install LibreOffice Add-in" button. If you get an error, refer to the [[:kb/word_processor_plugin_installation_error#libreoffice|installation troubleshooting instructions]] |
| |
| === Buttons are unresponsive after updating LibreOffice === | === Buttons are unresponsive after updating LibreOffice === |
| |
| Unresponsive Zotero toolbar buttons are an indication of LibreOffice not having access to a working Java JRE. Refer to the [[word_processor_plugin_troubleshooting#installation_error|Installation Error]] section. | Unresponsive Zotero toolbar buttons are an indication of LibreOffice not having access to a working Java JRE. Refer to the [[:kb/word_processor_plugin_installation_error#libreoffice|installation troubleshooting instructions]]. |
| |
| === Add Extension(s)...does not exist error === | === Add Extension(s)...does not exist error === |
Upgrade Storage