| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| word_processor_plugin_troubleshooting [2024/08/18 01:32] – dstillman | word_processor_plugin_troubleshooting [2025/02/20 04:06] (current) – [Mac] dstillman |
|---|
| |
| ===== All Plugins/Platforms ===== | ===== All Plugins/Platforms ===== |
| |
| ==== Formatting issues ==== | |
| Citations and bibliographies generated by the word processor plugins might appear in a different style (font, font-size, etc) than the surrounding text. The appearance of the generated text can be changed by changing the default style. For example, in LibreOffice, open the Styles Manager in Format -> Styles and Formatting or by pressing F12. Right-click on "Default", select "Modify", and make the desired changes to this style. In Word, open the Styles Manager in Format -> Styles or by clicking the "Styles Pane" or "Manage Styles" buttons on the "Home" tab of the ribbon. | |
| |
| Bibliography formatting is controlled by the citation style you select in Zotero document preferences and should conform to the requirements of the style in use. The formatting of the bibliography can be modified by editing the "Bibliography" (Word) or "Bibliography 1" (LibreOffice) word processor style. | |
| |
| ==== Zotero toolbar doesn't appear ==== | ==== Zotero toolbar doesn't appear ==== |
| |
| - Close Word or LibreOffice. | - Close Word or LibreOffice. |
| - Open the [[preferences|Zotero settings]], click the Cite tab, and scroll down to the Word Processors section. Click “Install Microsoft Word Add-in” or “Install LibreOffice Add-in”, and then restart your word processor. | - Open the [[preferences|Zotero settings]], click the Cite tab, and scroll down to the Word Processors section. Click “Install Microsoft Word Add-in” or “Install LibreOffice Add-in”, and then restart your word processor. If you get an error, see [[kb:word_processor_plugin_installation_error|Troubleshooting Errors with Word Processor Plugin Installation]]. |
| - If the Zotero tab or toolbar still doesn't appear in your word processor, follow the [[word_processor_plugin_manual_installation|manual installation instructions]]. | - If the installation completes but the Zotero tab or toolbar still doesn't appear in your word processor, follow the [[word_processor_plugin_manual_installation|manual installation instructions]]. |
| |
| If you still don't see the plugin after performing a manual installation, follow these OS-specific troubleshooting steps: | If you still don't see the plugin after performing a manual installation, follow these OS-specific troubleshooting steps: |
| |
| If you can insert a Zotero citation in a new, empty document but get an error in an existing document, see [[kb:debugging_broken_documents|Troubleshooting Errors in Word Processor Documents]]. | If you can insert a Zotero citation in a new, empty document but get an error in an existing document, see [[kb:debugging_broken_documents|Troubleshooting Errors in Word Processor Documents]]. |
| | |
| | ==== Formatting issues ==== |
| | |
| | Citations and bibliographies generated by the word processor plugins might appear in a different style (font, font-size, etc) than the surrounding text. The appearance of the generated text can be changed by changing the default style. For example, in Word, open the Styles Manager in Format → Styles or by clicking the "Styles Pane" or "Manage Styles" buttons on the "Home" tab of the ribbon. In LibreOffice, open the Styles Manager in Format → Styles and Formatting or by pressing F12. Right-click on "Default", select "Modify", and make the desired changes to this style. |
| | |
| | Bibliography formatting is controlled by the citation style you select in Zotero document preferences and should conform to the requirements of the style in use. The formatting of the bibliography can be modified by editing the "Bibliography" (Word) or "Bibliography 1" (LibreOffice) word processor style. |
| |
| ==== Field codes instead of citation/bibliography text ==== | ==== Field codes instead of citation/bibliography text ==== |
| ==== 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."// |
| * //"Word could not communicate with Zotero. Please ensure Zotero is running and try again.”// | * //"Word could not communicate with Zotero. Please ensure Zotero is running and try again.”// |
| |
| If you see one of the above errors in a **new, empty document** (and not just a [[kb:debugging_broken_documents|specific existing document]]), or if no citation dialog appears when you click the plugin buttons, try the following steps, testing after each one: | If you see one of the above errors in a **new, empty document** (and not just a [[kb:debugging_broken_documents|specific existing document]]), or if no citation dialog appears when you click the plugin buttons, try the following steps, testing the plugin after each one. |
| |
| - Restart your computer. Start Zotero before starting your word processor. | - Restart your computer. Start Zotero before starting 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