Word guide · Windows and Mac

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.

By André Antão Published 15 min read
The short answer
  1. Close Word, install Zotero from zotero.org/download and open it once. Zotero installs the Word plugin on its first start.
  2. Open Word. A Zotero tab is now on the ribbon. Keep the Zotero app running while you write.
  3. 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.
  4. 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.

  1. Close Word.
  2. Download Zotero from the Zotero download page and install it. WindowsRun the setup program. MacOpen the .dmg and drag Zotero to the Applications folder.
  3. 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.
  4. Start Word and look for the Zotero tab at the end of the ribbon.
Figure 1The Zotero tab in Word for Windows, simplified. It has five buttons: Add/Edit Citation, Add/Edit Bibliography, Document Preferences, Refresh (re-reads every citation from your Zotero library) and Unlink Citations (turns citations into plain text for good).

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.

If the tab doesn't appear

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.

  1. Click in the text where the citation should go.
  2. Choose Zotero › Add/Edit Citation. The first time in a document, Zotero asks for the citation style first (see section 04).
  3. 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.
  4. Press Enter (or click the match). The source becomes a shaded bubble.
  5. Press Enter again to insert the citation and close the dialog.
Figure 2The citation dialog, simplified, with two sources in one citation, and the result on page 10 of the sample thesis in APA 7. Zotero sorts the two sources alphabetically, adds "p. 23" from the page number typed in the dialog, and, with Omit Author ticked, inserts only "(1994)" after the names typed in the sentence.

Page numbers, several sources and narrative citations

  • Page numbers: before you press Enter the second time, type p.23, p23 or just 23 after the source, or :45-48 for 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, see in Prefix for "(see Morgan & Hunt, 1994)".
  • Edit a citation: click inside it in the document and choose Zotero › Add/Edit Citation again.
Never type inside a citation

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.

  1. Go to the end of the thesis, insert a page break (WindowsCtrl+Enter MacCmd+Return) and type the heading.
  2. Press Enter to start a new paragraph below the heading.
  3. Choose Zotero › Add/Edit Bibliography.
Figure 3The reference list of the sample thesis, built by Zotero in APA 7. You type the heading (here in Heading 1); Zotero writes the entries and gives them Word's Bibliography style, which carries the hanging indent and line spacing.

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.

Figure 4Document Preferences, simplified: the citation style, the language for dates and terms, and how citations are stored. The style names are those in the Zotero Style Repository. Leave storage on Fields unless you share the file with someone who uses LibreOffice.
  • 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.
The rule versus the style file

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

  1. Click inside any entry of the Zotero bibliography.
  2. 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.

  3. 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).
  4. 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.

Keep citations out of captions

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.

Windows
  • 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
Mac
  • Zotero settings: Zotero › Settings › Cite
  • Plugin check: Tools › Templates and Add-ins, Zotero.dotm ticked
  • 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.

07Sharing the file with a supervisor

Zotero citations in Word are fields: pieces of text that Word generates and that store hidden data, here the reference data Zotero needs. A field survives only in programs that support it. Zotero's knowledge base lists the ways a document loses its live citations, and most of them happen when a thesis goes to a supervisor and comes back.

  • Google Docs: opening a Word file directly in Google Docs breaks the citations. To move a file between the two, first save a copy with File › Save As under a new name. In that copy, choose Switch to a Different Word Processor… in Document Preferences and save it, then upload it from inside Google Docs with File › Open and click Refresh in the Zotero menu, as Zotero describes. Collaborating in Google Docs from the start is a separate set-up, in my guide to Zotero with Google Docs.
  • Apple Pages and most online editors don't support fields, and saving there flattens the citations.
  • Saving as .odt from Word loses the citations. Keep the thesis as .docx.
  • Word for the web keeps the fields, so comments added there are safe, but nobody can add a Zotero citation in it.
  • A supervisor without Zotero can comment and track changes in Word. They can't edit citations, and shouldn't type inside them.

Track Changes needs care. Zotero's page on errors in documents warns that inserting or editing a citation with Track Changes on can mark many or all citations as changed, show field codes or, on rare occasions, make Zotero think a citation is corrupted. Turn Track Changes off while you cite. Accept the supervisor's changes before your next round of citing. My guide to Track Changes in Word shows how to accept them all at once.

From the theses I format

When a thesis arrives with references that no longer update, a common cause is that the file passed through another program on the way back from feedback. The reliable check takes seconds: click a citation, then Zotero › Add/Edit Citation. If the dialog opens with that citation in it, the citation is still a Zotero field; if the dialog is empty, it has become plain text. A grey highlight on click is a quick hint too, unless Field shading is set to Never.

Citations already flattened and the deadline close?Send me the file and I'll put the references right

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

  1. Close Word, reinstall the add-in from the Zotero settings (Cite, then Word Processors) and restart Word.
  2. WindowsGo to File › Options › Add-ins. If Zotero.dotm is 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.
  3. 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.
  4. 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

Figure 5The same sentence twice: first with Word showing field codes, then showing field results. Nothing is broken: the code is the hidden reference data Zotero stores in each citation. Right-click and choose Toggle Field Codes to switch back.

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.

Don't press Ctrl+Shift+F9 on citations

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.

  1. Save the final thesis, then save a copy with File › Save As under a new name, such as thesis_submission.docx.
  2. In the copy, choose Zotero › Refresh one last time, then Zotero › Unlink Citations.
  3. 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.

How this was checked

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.

André Antão is a university lecturer in Management and Marketing at the Polytechnic University of Portalegre and a PhD candidate in Management. He has formatted theses in Word and LaTeX for 8 years.

Sources

  1. Using the Zotero Word Plugin Zotero Documentation
  2. Installing the Zotero Word Processor Plugins and Manually Installing the Zotero Word Processor Plugin Zotero Documentation
  3. Zotero Word Processor Plugin Troubleshooting Zotero Documentation
  4. Troubleshooting Errors with Word Processor Plugin Installation Zotero Documentation
  5. Troubleshooting Errors in Word Processor Documents Zotero Documentation
  6. Why isn't Zotero detecting my existing citations? Zotero Documentation
  7. Moving Documents with Zotero Citations Between Word Processors Zotero Documentation
  8. Why do I see code beginning with ADDIN ZOTERO_ITEM CSL_CITATION? and Why are Zotero citations highlighted in gray? Zotero Documentation
  9. References appear in the wrong font in Word/LibreOffice Zotero Documentation
  10. Zotero System Requirements, Installation, Citation Styles, Zotero Settings and Creating Bibliographies Zotero Documentation
  11. Zotero home page and Zotero integration source code (how the Bibliography style is set) Zotero
  12. View, manage, and install add-ins in Office programs Microsoft Support
  13. Customize or create new styles Microsoft Support
  14. Keyboard shortcuts in Word Microsoft Support