Zotero in Word: install the plugin and cite
To use Zotero in Word, install the Zotero desktop app and restart Word: the Zotero Word plugin comes bundled with Zotero, installs itself and adds a Zotero tab to the ribbon. Cite with Zotero › Add/Edit Citation, insert the reference list with Zotero › Add/Edit Bibliography, and choose APA 7 or any other style in Document Preferences.
- Close Word, install Zotero from zotero.org/download and open it once. Zotero installs the Word plugin on its first start.
- Open Word. A Zotero tab is now on the ribbon. Keep the Zotero app running while you write.
- Click where the citation goes, choose Zotero › Add/Edit Citation, type an author or title, press Enter to pick the source and Enter again to insert it.
- On the references page, choose Zotero › Add/Edit Bibliography. Zotero keeps the list up to date as you cite.
01Add Zotero to Microsoft Word: install the plugin
The Zotero Word plugin has no separate download. Zotero's installation page says the word processor plugins are bundled with Zotero and installed automatically for each supported word processor when you first start Zotero. Installing the Zotero desktop app is therefore all it takes to add Zotero to Word, as long as Word is closed while Zotero installs the plugin.
A word processor plugin is a small add-in that connects Word to the Zotero app on your computer. In Word, the plugin is a template file, Zotero.dotm, that Zotero copies into Word's Startup folder.
- Close Word.
- Download Zotero from the Zotero download page and install it. WindowsRun the setup program. MacOpen the
.dmgand drag Zotero to the Applications folder. - Start Zotero. On macOS 15 Sequoia, Zotero asks for permission to "access data from other apps". Click Allow: Zotero needs it to copy the plugin into Word's Startup folder.
- Start Word and look for the Zotero tab at the end of the ribbon.
Which versions of Word work with Zotero?
Zotero's system requirements list Word 2010 to 2024 or Office 365 on Windows (not Word 2010 Starter), and Word 2016 to 2024 or Office 365 on Mac. Zotero itself needs Windows 10 or later, or macOS 10.15 or later. Word for the web has no Zotero plugin: Zotero says Word Online keeps Zotero fields intact, so you can open the file there, but you can't add or update citations.
Close Word, open the Zotero settings (WindowsEdit › Settings MacZotero › Settings), choose Cite, then Word Processors, and click the button that installs or reinstalls the Microsoft Word add-in. Restart Word. If the tab is still missing, go to section 08.
02Insert a citation
A Zotero citation in Word is inserted from the citation dialog, which opens when you click Zotero › Add/Edit Citation. You type part of an author's name, a title or a year, choose the source from the matches and press Enter. Zotero writes the citation in the document's style, such as (Morgan & Hunt, 1994) in APA 7, and adds the source to the bibliography.
- Click in the text where the citation should go.
- Choose Zotero › Add/Edit Citation. The first time in a document, Zotero asks for the citation style first (see section 04).
- Type, for example,
morgan 1994. Matches from My Library and your group libraries appear below; sources already cited in the document are listed first, under Cited. - Press Enter (or click the match). The source becomes a shaded bubble.
- Press Enter again to insert the citation and close the dialog.
Page numbers, several sources and narrative citations
- Page numbers: before you press Enter the second time, type
p.23,p23or just23after the source, or:45-48for a range. Zotero calls this the locator; click the bubble to change its type (page, chapter, section and others). - Several sources in one citation: after picking the first source, don't press Enter. Type the next author or title and pick it too. Zotero orders the sources as the style requires (alphabetically in APA 7).
- Narrative citation ("Morgan and Hunt (1994) argue…"): click the bubble and tick Omit Author. Zotero inserts only "(1994)". Type the authors' names yourself in the sentence. In my example the names sit outside the field; only "(1994)" belongs to Zotero.
- Prefix and suffix: click the bubble and type, for example,
seein Prefix for "(see Morgan & Hunt, 1994)". - Edit a citation: click inside it in the document and choose Zotero › Add/Edit Citation again.
Zotero's documentation warns that editing a citation's text by hand stops Zotero updating it. Zotero asks you to confirm the edit, and from then on that citation won't change with the style, with "ibid." or with corrected data. Fix the source in your Zotero library and click Zotero › Refresh instead.
03Add the Zotero bibliography
A Zotero bibliography in Word is inserted with Zotero › Add/Edit Bibliography at the cursor. Zotero lists every source cited in the document, formatted in the document's style, and updates the list by itself as you add and remove citations. In APA 7 the list is called References; Zotero inserts the entries only, so type the "References" heading yourself and give it your chapter heading style.
- Go to the end of the thesis, insert a page break (WindowsCtrl+Enter MacCmd+Return) and type the heading.
- Press Enter to start a new paragraph below the heading.
- Choose Zotero › Add/Edit Bibliography.
Add a source you didn't cite, or leave one out
Click Zotero › Add/Edit Bibliography again with the cursor in the list. The bibliography editor opens, and its arrows add uncited sources to the list or remove cited ones (Zotero's documentation gives personal communications as an example). The same window lets you edit the text of an entry, but Zotero discourages it: edited entries stop updating and the edits don't always survive a refresh.
Corrections belong in your Zotero library. A wrong capital in a title, a missing DOI or an author entered as "Hunt, S" are fixed in the item in Zotero, then Zotero › Refresh rewrites every citation and entry. How the entries should look in APA 7 or Harvard depends on the style file, which my guide on changing the citation style in Zotero covers.
Three hundred references with odd capitals and missing DOIs?I can clean them up for you
04Choose the citation style: Document Preferences
The citation style of a Word document is set in Zotero › Document Preferences, and the choice is stored in that document. Choosing a different style there reformats every citation and the bibliography at once, so a thesis can move from Harvard to APA 7 in one click. Zotero ships with the common styles, and over 10,000 more are in the Zotero Style Repository.
- Citation Style: pick the style your university names. If it isn't listed, add it in the Zotero settings under Cite with Get additional styles…, then come back here.
- Language: sets the language of terms and dates in citations and the bibliography, such as "Retrieved" or month names.
- Footnotes or endnotes: shown only for note styles such as Chicago notes and bibliography. Word, not Zotero, controls how the notes themselves look.
- Store Citations as: Zotero's advice is to keep Fields unless you work with someone using LibreOffice. Bookmarks don't work with footnote styles and can occasionally corrupt citations.
A Zotero style is a file written to match a style guide, and universities often change the guide: "APA with numbered headings", Harvard variants that differ in punctuation, a school's own author-date style. The university's guide wins over any style file. If the output differs from your guide, check the guide's examples before you change anything in Word.
05Make Zotero match your thesis formatting
Zotero formats citations with Word's Normal style and the reference list with Word's Bibliography style, according to Zotero's documentation. A paragraph style is a named set of formatting that Word applies in one click. So when the references come out in Calibri in a Times New Roman thesis, or the spacing is wrong, the fix is to change those two styles in Word, not to reformat the text.
Zotero's page on the wrong font says inserting a citation can strip indents and line spacing from the whole paragraph, because the plugin applies the Normal style to the paragraph it inserts into. In theses I format, this is the usual reason why paragraphs typed with direct formatting suddenly lose their first-line indent after a citation is added. A body text style that carries the indent survives; formatting added by hand does not.
Change the Bibliography style
- Click inside any entry of the Zotero bibliography.
- WindowsOn the Home tab, right-click Bibliography in the Styles gallery and choose Modify. If it isn't in the gallery, open the Styles pane with Ctrl+Alt+Shift+S, point at Bibliography, click its arrow and choose Modify.
MacClick Styles Pane at the end of the Home tab, then the current style at the top of the pane, and choose Modify Style.
- Set the thesis font and size, then click Format and Paragraph in the dialog for line spacing, spacing before and after, and the hanging indent (0.5 in, or 1.27 cm, in APA 7; my hanging indent guide gives APA's source).
- Click OK. Every entry changes, and Zotero keeps your changes when it updates the list. One exception: each time you click OK in Zotero › Document Preferences, Zotero sets the indent, line spacing and spacing after of the Bibliography style again from the citation style, so check them after you change style. Font changes stay.
Do the same for Normal if the citations come out in the wrong font. The full steps for the indent, with Windows and Mac menus, are in my guide to the hanging indent in Word, and the font itself is covered in the guide to thesis fonts.
Zotero won't let you insert a citation into an image caption, and its page on errors in documents names a citation copied into a caption as the most likely cause of trouble in an existing file. If a figure needs a source, put the citation in the note below the figure instead.
06Zotero in Word for Mac
Zotero in Word for Mac works the same way as on Windows: the same Zotero tab, the same five buttons and the same citation dialog, in Word 2016 to 2024 or Microsoft 365. The differences are where the settings live, where the plugin file sits, and two Mac-only causes of failure: the macOS 15 permission prompt and clipboard utilities.
- Zotero settings: Edit › Settings › Cite
- Plugin check: File › Options › Add-ins, look for
Zotero.dotm - Startup folder:
%AppData%\Microsoft\Word\STARTUP - Show or hide field codes: right-click a citation, Toggle Field Codes, or Alt+F9
- Zotero settings: Zotero › Settings › Cite
- Plugin check: Tools › Templates and Add-ins,
Zotero.dotmticked - Startup folder:
~/Library/Group Containers/UBF8T346G9.Office/User Content.localized/Startup.localized/Word(paste it into Finder › Go › Go to Folder…) - Show or hide field codes: right-click, Toggle Field Codes, or Option+F9 (add Fn if your F-keys control brightness and volume)
If the Zotero tab is missing on a Mac, Zotero's troubleshooting page says to update Word to the latest version first, then check Tools › Templates and Add-ins: Zotero.dotm should be listed under Global Templates and Add-ins and ticked. If it isn't there, reinstall from the Cite pane. Clipboard history tools can block citations from being inserted; Zotero suggests disabling them while you test.
08Zotero tab missing or not working in Word: fixes
Most Zotero Word plugin problems fall into three groups: the Zotero tab doesn't appear, the buttons give an error in every document, or one existing document misbehaves. Zotero's own test separates them: if a citation works in a new, empty document but not in your thesis, the plugin is fine and the document is the problem.
The Zotero tab doesn't appear in Word
- Close Word, reinstall the add-in from the Zotero settings (Cite, then Word Processors) and restart Word.
- WindowsGo to File › Options › Add-ins. If
Zotero.dotmis under Inactive Application Add-ins, choose Word Add-ins in the Manage box, click Go… and tick it. If it is under Disabled Application Add-ins, choose Disabled Items, click Go…, select it and click Enable. - WindowsIn File › Options › Trust Center › Trust Center Settings › Add-ins, make sure Require Application Add-ins to be signed by Trusted Publisher and Disable all Application Add-ins are unticked. Restart Word.
- On a university-managed computer, IT policies can block add-ins. Zotero's advice is to contact your IT department.
If the tab appears but its label is empty, Word's macro settings are stopping the plugin: in Trust Center Settings, under Trusted Locations, check that Word's Startup folder is listed.
"Word could not communicate with Zotero"
The Zotero desktop app must be open; the Zotero website or browser connector isn't enough. If it is open, close Word, restart Zotero, then start Word. Next, restart the computer and start Zotero before Word. WindowsMake sure neither program runs as administrator. MacOn a Mac, this message usually means the plugin in Word is out of date: delete Zotero.dotm from the Word Startup folder, restart Word, then reinstall from the Zotero settings.
"This command is not available because no document is open"
Zotero's troubleshooting page says the Word plugin may not work for documents stored in OneDrive. Move the thesis to a local folder, or to one synced by Dropbox or Google Drive, which Zotero says are not affected, and try again. Zotero's page on errors in documents also suggests removing any spaces from the file name.
You see ADDIN ZOTERO_ITEM CSL_CITATION instead of citations
Word is showing the field code instead of its result. Right-click a citation and choose Toggle Field Codes, or press WindowsAlt+F9 MacOption+F9 (Option+Fn+F9 on keyboards where the F-keys control brightness and volume). If the codes keep coming back, untick Show field codes instead of their values in File › Options › Advanced (Windows), or Field codes instead of values in Word › Preferences › View (Mac; Settings in recent versions of Word). With Track Changes on, accepting the changed citations hides the codes again.
In Word for Windows, Ctrl+Shift+F9 unlinks the selected fields, according to Microsoft's list of keyboard shortcuts. On a Zotero citation that does the same as Unlink Citations: the citation becomes plain text and stops updating.
Citations are highlighted in grey
The grey shading marks Word fields on screen only. Zotero notes that it doesn't print and doesn't appear in a PDF. To change it, set Field shading to Never, Always or When selected in File › Options › Advanced (Windows) or Word › Preferences › View (Mac).
"You must insert a citation before performing this operation"
This message, a bibliography that misses sources, or a numeric style that restarts at [1] all mean the earlier citations are no longer live fields. They were unlinked, saved in another format or opened in a program without fields (section 07). Zotero lists three ways out: restore a backup, insert the citations again, or keep the text as it is and build the final list from a Zotero collection without the plugin. If only the bibliography is flattened, delete it and insert a new one.
An error in one document only
Restart Zotero and Word, update both, turn Track Changes off and accept existing changes, and delete any citation that was pasted into a caption. If the error persists, Zotero's method is to work on a duplicate of the file: switch the style, delete the bibliography, then delete half the content at a time until the citation that triggers the error is isolated. Remove that citation from the original and insert it again.
A 200-page thesis that errors on every refresh?I can find the broken citations for you
09Before you submit: Unlink Citations on a copy
Unlink Citations on the Zotero tab removes the field codes and turns every citation and the bibliography into plain text. Zotero's documentation says it can't be undone and should usually be used only on a final copy. Unlinking is optional: a PDF made from the live document looks the same, because the grey field shading never prints.
Unlink a copy when a hand edit is truly needed, for example an asterisk before references included in a meta-analysis, headings for primary and secondary sources, or a university rule the style file can't produce.
- Save the final thesis, then save a copy with File › Save As under a new name, such as
thesis_submission.docx. - In the copy, choose Zotero › Refresh one last time, then Zotero › Unlink Citations.
- Make the hand edits in the copy and keep the live version for any corrections the examiners ask for.
Choosing between Zotero, Mendeley and EndNote for a thesis, or moving from one to another, is a wider question that my guide to reference managers for Word compares side by side. If your library is in Mendeley, the equivalent steps are in Mendeley Cite in Word.
10Questions people ask
Is the Zotero Word plugin free?
Yes. The Zotero Word plugin is part of Zotero, which Zotero describes as a free tool, and it is installed with the Zotero desktop app. There is nothing separate to buy or download for Word.
Does Zotero work in Word for the web?
No Zotero plugin exists for Word for the web. Zotero says Word Online keeps existing Zotero fields intact, so you can read and comment on the file there, but citations are added and updated only in desktop Word.
Can I use Zotero in Word without the plugin?
Yes, as static text. In Zotero, select items and press Ctrl+Shift+C (Cmd+Shift+C on a Mac) to copy a formatted bibliography, or Ctrl+Shift+A for citations, then paste into Word. Pasted text never updates, so for a thesis the plugin is the better choice.
How do I delete a Zotero citation in Word?
Select the whole citation and delete it like ordinary text. Zotero removes the source from the bibliography at the next update, unless the source is cited somewhere else; click Zotero › Refresh if the list hasn't changed yet.
Why doesn't the Zotero bibliography update?
A Zotero bibliography stops updating when it, or the citations, have become plain text: click a citation and then Zotero › Add/Edit Citation: if the dialog opens empty, the citation is no longer live. If the fields are live, click Zotero › Refresh; if the bibliography alone is plain text, delete it and insert a new one.
Is Zotero better than Word's own References tool for a thesis?
For a thesis with hundreds of sources, a reference manager such as Zotero is usually easier: it stores PDFs and notes, offers thousands of styles and shares a library across documents. The comparison is in my guide to Word's built-in citations and bibliography.
Checked on against Zotero's current documentation, when Zotero 10.0.7 was the current release (plugin usage, installation, manual installation, troubleshooting, system requirements and the knowledge-base pages listed under Sources) and Microsoft Support's pages for Word for Microsoft 365. The ribbon and dialogs are drawn from those descriptions and simplified. Zotero changes its dialogs between versions, so a label may differ slightly in yours.
Sources
- Using the Zotero Word Plugin Zotero Documentation
- Installing the Zotero Word Processor Plugins and Manually Installing the Zotero Word Processor Plugin Zotero Documentation
- Zotero Word Processor Plugin Troubleshooting Zotero Documentation
- Troubleshooting Errors with Word Processor Plugin Installation Zotero Documentation
- Troubleshooting Errors in Word Processor Documents Zotero Documentation
- Why isn't Zotero detecting my existing citations? Zotero Documentation
- Moving Documents with Zotero Citations Between Word Processors Zotero Documentation
- Why do I see code beginning with ADDIN ZOTERO_ITEM CSL_CITATION? and Why are Zotero citations highlighted in gray? Zotero Documentation
- References appear in the wrong font in Word/LibreOffice Zotero Documentation
- Zotero System Requirements, Installation, Citation Styles, Zotero Settings and Creating Bibliographies Zotero Documentation
- Zotero home page and Zotero integration source code (how the Bibliography style is set) Zotero
- View, manage, and install add-ins in Office programs Microsoft Support
- Customize or create new styles Microsoft Support
- Keyboard shortcuts in Word Microsoft Support