A blank Word document is the first diagnostic: test it before reinstalling Zotero, then fix only the layer the result points to. This approach applies whether the toolbar is missing, a citation button does nothing, Word cannot communicate with Zotero, or only an existing paper fails.
This guide is for researchers using Zotero 10 and Microsoft Word for Mac who need to resume citation work without risking a thesis draft.
If the toolbar is missing, focus on plugin installation and Word’s startup folder.
If a blank document works but an older paper does not, preserve the original and investigate that document separately.
Start with a blank-document test
First, confirm that Zotero and Word are both open in the current macOS user session. Create a new blank Word document and try inserting a citation. Record what happens: whether the Zotero toolbar appears, whether the citation window opens, whether Word displays a connection or permission message, and whether a citation is actually inserted.
This test separates a plugin-wide problem from a document-specific one. A toolbar that is absent in both a blank document and an existing paper points toward loading or installation. A toolbar that appears but cannot open a citation window suggests a communication, permission, or application-state problem. If the blank document works while an older paper fails, do not keep reinstalling the plugin: the original document needs its own diagnosis.
| What you observe | Most relevant layer | Low-risk next action |
|---|---|---|
| Zotero toolbar is missing in a blank document | Plugin loading or Word startup folder | Reinstall through Zotero’s citation settings; then check the startup-folder path |
| Toolbar appears, but clicking a citation control has no effect | App communication or Word state | Restart both apps; confirm they are running in the same user session |
| Word reports that it cannot connect to Zotero | Communication or macOS Automation permission | Check the permission prompt and macOS Automation settings |
| A citation inserts in a blank document but not in an older paper | Document fields or document structure | Make a copy and test the document-specific repair steps |
| Plugin installation reports an error | Installation files or destination-folder access | Remove only the relevant old plugin file, then follow the official installation steps |
A visible toolbar is not proof that the entire workflow works. Verify each stage separately: the toolbar loads, the citation window opens, and a citation is written into the document.
Keep the original paper unchanged during diagnosis. Use a copy for repairs, and do not remove fields or make structural edits in the only copy of a thesis chapter.
Zotero’s official version history lists Zotero 10.0.5 dated September 30, 2026. That confirms a release entry, not that a Zotero 10 update caused a particular Word failure. Check the official Zotero version history again before publishing or following version-specific advice, since the version state can change.
Why is Zotero 10 missing from the Word toolbar?
A missing toolbar usually means Word has not loaded the plugin from its active startup folder, or the plugin needs to be installed again. Close Word before reinstalling; otherwise, Word may still be using the previous plugin state when it starts again.
Use this sequence:
- In Zotero, open the citation or word-processor settings and choose the option to install or reinstall the Word plugin.
- Wait for the installation to finish, then fully quit Word. Reopen it and inspect the ribbon for Zotero controls.
- If the toolbar is still absent, check Word’s configured startup folder. The plugin file,
Zotero.dotm, must be in the folder Word actually uses, not simply in a folder that seems like a likely default. - Compare the configured location with the path described in Zotero’s Mac manual installation instructions. Follow those instructions only if automatic installation has not resolved the issue.
- If the installation reports an error, use Zotero’s plugin installation error guidance rather than deleting unrelated templates or Word files.
The startup-folder check matters because Word can be configured to use a different location from the one a user expects. Installing Zotero.dotm into the wrong folder can leave the toolbar missing even though the file exists somewhere on the Mac. Confirm both the configured folder and the presence of the plugin file before changing anything.
If the Mac is managed by a university, the startup folder may also have restricted access. Check whether the current user can read and write to the intended folder. If access is controlled by an institutional policy, ask campus IT to confirm the approved path instead of changing security settings or permissions broadly.
After reinstalling, test in a blank document. If the toolbar appears but the citation control does not work, stop repeating the installation step and move to the communication checks. Zotero’s Word plugin installation documentation describes the supported installation route if the settings or plugin options are unclear.
What to do when Word cannot insert a citation
When Zotero opens but Word cannot insert a citation, first establish whether both apps are running normally in the same current-user session. Save any open work, quit Word and Zotero, reopen Zotero, then open Word and try the blank-document test again. This clears a stale app state without changing the document or removing plugin files.
If the toolbar is present but no citation window appears, distinguish a click that produces no visible response from a message that explicitly says Word cannot communicate with Zotero. Capture the exact message if one appears. Then check whether macOS is allowing Zotero to control Word through Automation. Zotero describes the relevant permission state in its Mac Word permissions guide, and Apple explains how to review app-control permissions in its macOS Automation settings instructions.
Use the following checks in order:
- Confirm Zotero is open and responsive before testing the Word toolbar.
- Restart both apps, then retry in a new blank document.
- If macOS displays an Automation prompt, read it and allow the requested control only if it matches the Zotero-to-Word workflow.
- If the prompt was dismissed or the permission appears incorrect, review the Automation settings using the official guidance. Avoid disabling unrelated privacy protections.
- If the setting is locked or unavailable on a university-managed Mac, contact campus IT. Do not try to bypass the organization’s management policy.
- If communication still fails, follow Zotero’s Word plugin troubleshooting steps before removing and reinstalling plugin files.
Do not treat three different outcomes as interchangeable. A toolbar can be visible while its controls fail; a citation window can open while insertion fails; and a citation can be inserted successfully even if an existing document later has a separate problem. Record which stage fails so the next support request contains evidence rather than the broad description “Zotero is broken.”
A full reinstall is not the first response to every failure. If the toolbar is loaded and the issue is an Automation permission or a single document’s fields, reinstalling can add work without addressing the cause.
Can macOS Automation permissions block Zotero from controlling Word?
Yes. macOS may require permission for one application to control another. If Zotero cannot communicate with Word, the relevant Automation permission is worth checking, but a missing toolbar alone does not establish that permissions are the cause.
Look for a permission message and review the Automation controls described in Apple’s documentation. If Zotero’s ability to control Word is denied or unavailable, use the supported settings to correct it. If a managed-device profile prevents changes, ask the university’s IT team to review the policy. A student or researcher should not disable general security features or make broad permission changes to force the plugin to work.
Keep the diagnosis narrow. A permission change should relate to Zotero controlling Word, not grant unrelated access. After changing an approved setting, close and reopen both apps and repeat the blank-document test. Success means more than seeing the toolbar: confirm that the citation window opens and that a citation is inserted.
When an old paper fails but a blank document works
If a new document accepts citations but an older paper does not, treat the older document as the primary suspect. That result makes a general plugin-loading failure less likely, though it does not by itself identify the exact problem. Keep the original file intact and make a separate test copy before checking fields, tracked changes, or document structure.
Start with Zotero’s Word document troubleshooting guidance. Compare the behavior in the copy with the blank-document result. Note whether the failure affects one citation, a section, or the entire paper, and whether Word displays a specific error. Avoid deleting citation fields or converting citations to plain text in the original: those actions can remove the link between a citation and Zotero’s editable field data.
A careful document test should follow this order:
- Duplicate the paper and give the copy a clear test name.
- Open the copy and try the operation that failed, without changing the original.
- Check whether the issue follows a particular citation or part of the document.
- Review tracked changes and document structure in the copy, changing one factor at a time.
- If a repair is needed, use Zotero’s documented procedure and inspect the result before carrying the change back to the working draft.
For research writing, the safe outcome is not merely a document that opens. Confirm that citations remain editable and that the bibliography still reflects the paper’s citation fields. If an alteration changes citation behavior or bibliography output, return to the untouched original and consult Zotero support or campus IT before continuing.
Acceptance checks and next steps
Before returning to the main paper, run a small acceptance test in a blank document. Keep the test limited to the basic workflow:
- Open Zotero and Word in the same user session.
- Open a new blank Word document and confirm the toolbar appears.
- Open the citation dialog from the toolbar.
- Insert a test citation and confirm it appears in the document.
- Generate or refresh the bibliography and confirm the workflow completes.
- Repeat the test in a copy of the affected paper only if the blank document works.
Record the macOS and app versions shown on the Mac, the exact error message, whether the blank document works, and which acceptance step fails. The official Zotero version history and plugin instructions are the appropriate sources for checking whether a later update changes the steps. This record also helps campus IT distinguish an installation issue from a managed permission or document problem.
Last updated October 6, 2026. The version statement and troubleshooting steps were checked against the official Zotero version history, Word plugin troubleshooting, installation guidance, and macOS Word permission documentation linked above. Recheck these official sources after a relevant Zotero, Word for Mac, or macOS update.
If a lab’s existing Linux or Windows machines cannot reproduce a macOS-only issue, they cannot replace the macOS part of the test. Borrowing a shared Mac can make reproduction dependent on access and local setup; buying a Mac creates an upfront purchase for a problem that may only need investigation. A remote Mac is not necessary for every Zotero fault, and it will not repair a damaged paper by itself. But when the problem must be reproduced in macOS and no suitable Mac is available, RUVCLOUD’s remote Mac environment can be considered for a separate blank-document acceptance test without making a permanent hardware purchase. Review the RUVCLOUD Mac rental options and decide whether remote access fits the lab’s privacy, software, and institutional requirements before moving research files.