Skip to main content
v2026.11,610 entries · CC-BY 4.0

Using Zotero with Google Docs: The Word Round-Trip and Shared-Document Failures

Zotero stores Google Docs citations as links, not field codes. That single fact explains the dead citations after a .docx download, the collaborator who silently unlinks half a bibliography, and the wrong-Google-account permission error.

Ask about Using Zotero with Google Docs: The Word Round-Trip and Shared-Document Failures

Answers are drawn from this guide and the rest of the CASRAI corpus, with a link to every source.

Answers are AI-generated from CASRAI’s own published pages and can be wrong, so check the linked sources before relying on one; your question is logged without personal data — never sold, never used to train a third-party model — to show us what CASRAI is missing, so please do not type personal or confidential details. How we use this

Written and maintained by CASRAI Editorial Board

Last updated

Zotero’s Google Docs integration is the only first-party Google Docs citation plugin among the major reference managers, and it is genuinely good until the moment a manuscript has to leave Google Docs — or the moment a co-author who is not set up correctly touches it. Both failures come from the same place: Google Docs stores Zotero citations by a completely different mechanism than Word and LibreOffice do, and almost every broken-citation story on a shared draft traces back to that one design fact.

This page is about that mechanism and the failures it produces — the Google Docs to Word hand-off, the collaborator who unlinks half a bibliography without knowing it, and the permission error that stops a co-author dead. If you need the install-and-repair layer instead (Connector not saving, Word tab missing, sync and storage errors), that is covered separately in Zotero setup and troubleshooting, and the day-to-day library workflow is in Zotero for researchers.

Everything below was checked against Zotero’s own documentation at zotero.org/support in August 2026, with the last-updated date of each source page stated where it matters. This integration has changed materially over its life and a large amount of guidance published elsewhere describes behaviour that has since moved — see Dates, versions, and what we could not confirm before trusting any older walkthrough, including this one in a year’s time.

The mechanism: why Google Docs citations are structurally more fragile

In Word and LibreOffice, a Zotero citation is stored inside the document file itself as a field code (or, optionally, a bookmark). The word processor owns that container; ordinary editing cannot casually destroy it, and it travels with the file.

Google Docs has no equivalent container available to a browser extension. So Zotero stores each citation as a link — a marker pointing at a URL of the form https://www.zotero.org/google-docs/?abc123 — plus document-level metadata that maps those markers back to items in your Zotero library. The rendered citation text you see is regular document text; the link is the only thing making it a Zotero citation.

Zotero states the consequence plainly in its knowledge base: “Google Docs integration uses a different mechanism for storing citations than is used in the Word and LibreOffice plugins, and it can be easier for citations to accidentally become unlinked.”

Three things follow, and they explain nearly every failure on this page:

  • Anything that strips or duplicates the link breaks the citation. The text survives; the connection to your library does not. A broken marker is silently invisible — it still reads like a citation.
  • The Zotero Connector is what interprets those markers. A person editing the document without the Connector installed is editing raw links they cannot see as citations.
  • Nothing about your document goes to Zotero’s servers. Per Zotero’s Google Docs documentation, the integration “works entirely locally on your computer, so even when you trigger the plugin on a given document, nothing is sent to Zotero servers.” The zotero.org URL in the marker is an identifier, not a fetch.
Surface How the citation is stored What destroys it
Word Field code (or bookmark, if selected in Document Preferences) Accepting a “convert to plain text” operation; saving to a format that drops fields
LibreOffice Reference mark (or bookmark) Same as Word; bookmark mode also breaks on footnote styles
Google Docs In-document link to zotero.org/google-docs/?<key> plus document metadata Dragging a citation with the mouse; cut-and-paste by anyone without the Connector; downloading the file without converting first

The Google Docs to Word round-trip — the only supported path

There is a supported conversion, and it is not the one most people try. Zotero’s knowledge-base page “Moving Documents with Zotero Citations Between Word Processors” (last updated 2025-02-14) documents it. The plugin converts the citations and bibliography into a temporary transfer format that survives the file format change, and the receiving plugin restores them on a Refresh.

Google Docs to Word

  1. In the Google Doc, use File → Make a copy…. Do the conversion on the copy, not the original — the process should be reversible, but Zotero itself recommends working on a copy, and this keeps a known-good live-citation version of the manuscript.
  2. In the new document, select “Switch word processors…” from the Zotero menu.
  3. Select File → Download as → Microsoft Word (.docx) and save the converted file.
  4. Open the downloaded file in Word and click Refresh in the Zotero plugin. Citations are live again, and the bibliography regenerates from them.

Word to Google Docs (the reverse trip, with a different menu label)

The reverse direction is genuinely different, and the label difference is a real trap:

  1. In Word, File → Save As… a copy as .docx with a new filename (Zotero’s example: “My Document – Transfer.docx”).
  2. Click Document Preferences in the Zotero plugin and select “Switch to a Different Word Processor…” — in Word and LibreOffice this lives inside Document Preferences, not on the top-level menu the way “Switch word processors…” does in Google Docs.
  3. Save the converted file (File → Save).
  4. From within a Google Doc, use File → Open… to upload it.
  5. Select Refresh from the Zotero menu in the opened Google Doc.

Google Docs to LibreOffice

Identical to the Word route, except step 3 is File → Download as → OpenDocument Format (.odt). Coming the other way, from LibreOffice into Google Docs, there is one extra step Zotero calls out: after opening the uploaded file, use File → Save as Google Docs to leave .docx mode before refreshing.

One related note if your team splits between Word and LibreOffice but never touches Google Docs: you can avoid the conversion entirely by selecting Bookmarks rather than Fields in Document Preferences, which produces citations both applications can read. Zotero’s own caveat is that bookmark storage “does not work with footnote styles and may occasionally lead to citation corruption” — so it is a convenience for author-date manuscripts, not a general recommendation.

The three hand-offs that produce dead citations

Each of these is something a reasonable person does, and each produces a document that looks fine and is not.

1. File → Download as .docx, without switching first

This is the most common failure, because it is the obvious action. Without the conversion step, the Word document you get contains no field codes at all. Zotero’s Google Docs documentation is explicit about what appears instead: “if you download the document instead of first making a copy and unlinking citations, active citations in the document will show up as links leading to URLs such as https://www.zotero.org/google-docs/?abc123.”

So the diagnostic is unmistakable once you know it. If your .docx shows citations as blue hyperlinks to zotero.org, you took the download shortcut, and no amount of clicking Refresh in Word will recover them — Word’s plugin is looking for field codes that were never written. Current Zotero builds do prompt you to create a copy when you try to download a document with live citations, which catches some of these before they happen, but the prompt is a guard, not the conversion.

2. Copy and paste into Word

Selecting the whole Google Doc and pasting into Word carries formatted text and hyperlinks. There were never field codes to carry, so there is nothing for the Word plugin to find. The bibliography pastes as static text that will never update again. This is the same reason that pasting between two Google Docs is safe only when the Connector is installed on the pasting user’s browser — see the collaboration section below.

3. Unlink Citations, then export

Unlink Citations does exactly what it says: it removes the field codes and converts citations and bibliography to ordinary text, permanently. Zotero’s documentation flags it directly — “removing field codes is irreversible and should usually only be done in a final copy of your document.”

Used deliberately, this is the correct final step, and Zotero’s recommended publication workflow is built on it: File → “Make a copy…”, then in the copy use Zotero → “Unlink Citations”, then download that second document as PDF or .docx, keeping the original with live citations for further revisions. Used accidentally — or used before you realise a co-author still needs to add three references — it is a one-way door, and your only recovery is Google Docs version history.

What happens to the bibliography

The bibliography is not a list you maintain; it is a Zotero-managed field regenerated from the set of live citations in the document. Four consequences worth knowing before a submission deadline:

  • Manual edits are overwritten. Zotero’s documentation states that “manual edits made to the bibliography in the document will be overwritten the next time Zotero refreshes the document.” Typing a correction directly into a reference is wasted work.
  • An unlinked citation vanishes from it. Because the bibliography is built from live citations, a citation that has lost its marker stops contributing a reference — the in-text text remains, the reference silently disappears. This is what makes unlinking dangerous rather than merely annoying: the damage shows up as a missing entry, and nobody proofreads a reference list for absences.
  • After a successful transfer and Refresh, it rebuilds correctly. You do not need to move the bibliography separately; restoring the citations restores it.
  • Legitimate manual edits belong on an unlinked copy, last. Asterisks marking studies included in a meta-analysis, bolded or all-caps author names, annotations, and headings splitting primary from secondary sources are all things Zotero explicitly points at the copy-then-unlink route for. Corrections to style belong in the CSL style; corrections to data belong in your library.

The Edit Bibliography window also lets you add uncited sources (a review’s included-studies list) or suppress cited items that should not appear as references (personal communications) — do that in the window rather than by typing, since those changes are stored and survive a refresh.

If you are still deciding which conventions apply, citation styles and referencing formats covers the style layer, and the bibliography term entry covers what belongs in one.

The permission failure that stops a collaborator dead

The most confusing error in this integration is not about Zotero at all. Zotero’s Google Docs troubleshooting lists it verbatim:

“The Google account you selected does not have permission to edit this document” — You likely selected the wrong Google account.

The first time anyone triggers Zotero in a given document, Google prompts for authorization. Two things have to be right, and Zotero’s documentation is specific about both:

  1. Select the Google account that created the document, or the one that was granted editing access by the document’s creator. This is unrelated to any zotero.org account — a zotero.org account is not required for the Google Docs integration at all.
  2. Grant the permission “See, edit, create and delete all your Google Docs documents.” Zotero requires this scope in order to insert and modify citations. Zotero’s stated behaviour is that the plugin does nothing else with document content and does not access documents other than the ones it is triggered on, and that the work happens locally.

In a research group this bites in a predictable pattern. Someone is signed into a personal Gmail account and an institutional Workspace account in the same browser, the document was shared with the institutional one, and Chrome offers the personal one at the authorization prompt. The citation dialog then refuses to write. The fix is to redo the authorization with the correct account, not to reinstall anything.

A related check worth making before blaming the software: edit access is a hard requirement. A collaborator with Comment or View access cannot insert or edit citations, because the plugin cannot write to the document. And if your institution’s Google Workspace administrators restrict third-party app access, the authorization prompt is where that restriction surfaces — that is an admin setting on your organisation’s side, not a Zotero fault, and it is worth confirming with IT before a whole lab tries and fails.

Two further failure modes from the same troubleshooting page, both worth ruling out early because they present as “Zotero is broken”:

  • The Zotero menu does not appear, or shows a thin grey line. Restart Zotero and the browser; if that fails, disable other browser extensions and reload. Zotero specifically names the Google Docs Offline extension as having been reported to interfere.
  • The Connector lacks permission to run. In Chrome or Edge, right-click the Save to Zotero toolbar button, select “This Can Read and Change Site Data”, and choose “On All Sites”. In Safari, open the Websites tab of Safari settings, select Zotero Connector, and set the listed sites and “For other websites” to Allow.

The collaborator without the Connector — the real team failure

This is the failure that costs teams the most, and it is entirely invisible while it is happening.

Zotero’s recommendation is unambiguous: everyone making changes to the document should have the Zotero Connector installed. The Zotero desktop app is needed only by people who insert or edit citations — a co-author who is only editing prose needs the browser extension, not the application. That is a low enough bar to actually enforce across a group.

What happens when it is not enforced, in Zotero’s own words: “If someone cuts and pastes an active citation without the Zotero Connector, the citation will be unlinked from Zotero and disappear from the bibliography, and the next person refreshing the document with the Zotero Connector will receive a warning about unlinked citations.” Zotero goes further and advises against people without the Connector editing even non-citation parts of the document, “due to the risk of accidental citation unlinking.”

Two more unlinking triggers documented in the Limitations section, which catch people who do have the Connector:

  • Dragging a citation with the mouse unlinks it. Cutting and pasting is fine — with the Connector installed. Drag-to-reorder a sentence, and the citation inside it can come loose.
  • Viewing without the Connector shows raw markers. A reader without the extension sees the zotero.org links, which is alarming but harmless as long as they do not edit.

Recovering unlinked citations — and the trap in the recovery

Zotero gives two recovery routes, and the version-history one has a subtlety that costs people a second attempt:

  1. Google Docs version history (File → Version history → See version history), restoring to a version from before the unlinking. The warning about unlinked citations appears on the next operation after the one that caused the problem — so a version that does not immediately show a warning is not proof of a clean version. You must press Refresh in the Zotero menu after restoring and confirm the warning does not reappear. If it does, go back further.
  2. Reinsert the affected citations manually with the plugin. Slower, but deterministic, and the right choice when the unlinking happened many edits ago and rolling back would discard real work.

If everyone genuinely has the Connector and citations still unlink, Zotero asks that you identify the triggering action through version history and report it on the forums with the details.

Two people citing at the same time

Google Docs is built for simultaneous editing, and Zotero supports collaborative citing — you and your co-authors can all insert and edit citations in a shared document, and you do not need to be in a Zotero group to do it. But Zotero draws an explicit line at concurrency:

“When working collaboratively on a document, you and your coauthors should avoid inserting or editing citations at the same time. The Zotero Connector has mechanisms in place to prevent document and citation corruption from concurrent citation editing, but due to technical limitations they do not provide perfect safety.”

That is a vendor telling you the safety net is imperfect. Treat it as a workflow constraint, not a warning to ignore: on a manuscript with several citing authors, run citation passes in sequence rather than in parallel — one person announces they are doing a citing pass, everyone else stays out of the Zotero menu until it is done. Prose editing in parallel is fine, provided everyone has the Connector.

Orphaned items — the group-library argument

The second collaborative problem is metadata ownership. When a co-author cites from their own personal library, the item is linked to their library, not yours. Zotero calls the result orphaned items: items “not connected to any items in your Zotero database”, which show no “Open in My Library” button in the citation dialog. The practical consequence is stated directly in Zotero’s collaboration guidance — “if someone cites an item from their personal library, only they will be able to update the metadata for that item.”

So a wrong author name or a missing year in a co-author’s item is a problem only that co-author can fix, and if they have left the project you cannot repair it in place at all. This is why Zotero recommends a group library for any large collaborative project: it lets all collaborators change cited item metadata. The ownership, storage and succession consequences of that choice — including the fact that group file storage draws on the group owner’s plan — are worked through in citation management software for a research group.

The long-document ceiling

Zotero documents a concrete performance limit that matters for theses and reviews: “Citation inserts and edits slow down significantly as the number of citations increases. With 100+ citations, a single citation update can take up to 10 seconds, so for longer documents you’ll want to disable automatic citation updates in the Zotero document preferences.”

That setting has a visible side effect worth expecting rather than reporting as a bug: with automatic updates disabled, Zotero inserts citations with a grey background to signal that the text is not final. The grey clears when you click Refresh. (In Word and LibreOffice the equivalent state shows as dashed underlining instead.)

Google Docs also gives Zotero less typographic control than Word does. Styles requiring true small caps fall back to the “Alegreya Sans SC” font rather than real small-caps formatting — relevant mostly to legal and some humanities styles.

Taken together, these are the legitimate reasons a long manuscript migrates to Word partway through, which is precisely why the round-trip above matters. If the choice is still open, Google Docs vs. Overleaf vs. Word for co-authored manuscripts compares the three environments, and LaTeX and Overleaf for collaborative research writing covers the third option, where citation handling is a different problem entirely.

Pre-submission checklist for a shared Google Doc

Run this before the manuscript leaves the team, in order:

  1. Confirm every current editor has the Zotero Connector installed. Ask, do not assume — this is the single highest-yield check on the list, and the app is only needed by people who cite.
  2. Click Refresh in the Zotero menu and read the result. No unlinked-citations warning is your evidence that the citation layer is intact. If a warning appears, resolve it now, via version history or reinsertion, before anything else.
  3. Spot-check the bibliography against the in-text citations. You are looking for references that should be there and are not — the signature of a silently unlinked citation.
  4. Check for orphaned items if co-authors cited from personal libraries, and fix metadata now while the person who owns each item is still reachable.
  5. If the target is Word: make a copy, use Zotero → “Switch word processors…” in the copy, download as .docx, open in Word, and click Refresh. Confirm the citations are live in Word before you touch anything else.
  6. If the target is a flat file for submission: make a copy, use Zotero → “Unlink Citations” in the copy, make any final bibliography edits there, and export. Keep the original with live citations.
  7. Never do steps 5 and 6 on the original. The live-citation document is the version you will need when the reviewers come back.

The version-control questions this raises for a multi-author draft — who holds the master, how revisions merge back — are handled in managing manuscript versions across co-authors and track-changes etiquette for co-authored manuscripts.

Dates, versions, and what we could not confirm

This integration has changed materially over its life, and a great deal of published guidance describes behaviour that has since moved. Being explicit about what was checked, and when:

  • Zotero’s main “Using Zotero with Google Docs” documentation page carries a last-updated date of 2026-05-14. The Authorization, Collaboration, Saving for Publication, Limitations and Troubleshooting behaviour described above is taken from that version of the page.
  • Zotero’s knowledge-base page “Moving Documents with Zotero Citations Between Word Processors” carries a last-updated date of 2025-02-14. The round-trip procedures above are taken verbatim from it.
  • Zotero’s knowledge-base page “Why isn’t Zotero detecting my existing Google Docs citations?” carries a last-updated date of 2023-09-07. The unlinking causes and the version-history recovery caveat come from it.

One discrepancy we are flagging rather than resolving. The 2026-05-14 Google Docs page enumerates the Zotero menu as five items — Add/Edit Citation, Add/Edit Bibliography, Preferences, Refresh, and Unlink Citations — and does not list “Switch word processors…” among them, while the knowledge-base page that documents the conversion still instructs you to select it from that menu. We could not confirm from Zotero’s own documentation whether the item is present under that exact label in the current Connector build, or whether the menu enumeration is simply incomplete. Zotero’s forums also carry threads reporting the feature failing, including ones titled “‘Switch Word Processor’ feature in Google Docs Not Working” and “Switch word processors from word to docs not working” — we have not verified what resolved them.

What to do with that: open your own Zotero menu in Google Docs and look. If “Switch word processors…” is there, the procedure above applies as written. If it is not, check Document Preferences for an equivalent option before concluding the feature is gone, and ask on the Zotero forums rather than falling back on a download-and-hope. What is certain either way is the negative claim, which has been stable for years and is the part that actually costs people work: a plain download, a copy-paste, or an export from Docs produces dead citations, and no conversion after the fact will bring them back.

Zotero ships frequent point releases and menu labels move between them. Where a step here does not match what you see, the linked zotero.org page is the authority, not this one.

Frequently asked questions

Is there a Zotero add-on to install for Google Docs?

No, and looking for one in the Google Workspace Marketplace is a common dead end. Google Docs support is provided by the Zotero Connector browser extension (Chrome, Firefox, Edge, Safari) and requires the Zotero program to be running for inserting and editing citations. With the Connector installed and you signed into Google, a Zotero menu appears in the Docs menu bar by itself, along with a one-click citing button in the toolbar.

Can I convert a Google Doc with Zotero citations to Word and keep them live?

Yes, but only through Zotero’s own conversion: make a copy, select “Switch word processors…” from the Zotero menu in the copy, download that as .docx, then open it in Word and click Refresh. Downloading directly, or copying and pasting, produces dead citations that Word’s plugin cannot recover.

Why do the citations in my downloaded .docx look like zotero.org links?

Because you downloaded the document without converting it first. Those links are the storage mechanism Zotero uses inside Google Docs, exposed. Go back to the original Google Doc, which still has live citations, and run the conversion properly.

Does every co-author need the Zotero desktop app?

No. Everyone editing the document should have the Connector; only people inserting or editing citations need the Zotero application. Zotero advises against anyone without the Connector editing the document at all, including non-citation text, because of the unlinking risk.

Can two people insert citations at the same time?

Technically yes, and Zotero has safeguards against corruption from concurrent citation editing — but Zotero states those safeguards “do not provide perfect safety” and advises against it. Stagger citing passes; edit prose in parallel freely.

What does “The Google account you selected does not have permission to edit this document” mean?

You authorized the Zotero plugin with the wrong Google account — most often a personal account when the document was shared with an institutional one. Redo the authorization with the account that created the document or was given edit access. Also confirm you actually have edit access rather than comment or view access.

Is Unlink Citations reversible?

No. Zotero’s documentation states that removing field codes is irreversible and should usually only be done in a final copy. Always unlink on a copy, never on your working document. If you unlinked the original by accident, Google Docs version history is your only route back.

Why do my new citations have a grey background?

Automatic citation updates are disabled in Document Preferences — a setting Zotero recommends for documents with 100+ citations, where a single update can otherwise take up to 10 seconds. The grey signals that the citation text is not final; it clears when you click Refresh.

Sources checked August 2026: Zotero’s “Using Zotero with Google Docs” documentation (last updated 2026-05-14), “Moving Documents with Zotero Citations Between Word Processors” (2025-02-14), and “Why isn’t Zotero detecting my existing Google Docs citations?” (2023-09-07), all at zotero.org/support. Where this page could not confirm current behaviour, it says so above rather than describing what used to be true.

Follow CASRAI

Research-administration guidance, standards updates and independent tool reviews.

Referenced across the research world

University of Cambridge logoColumbia University logoCrossref logoUniversity of Edinburgh logoHarvard University logoUniversity of Oxford logoPrinceton University logoStanford School of Medicine logoUniversity College London logoORCID logoUniversity of Cambridge logoColumbia University logoCrossref logoUniversity of Edinburgh logoHarvard University logoUniversity of Oxford logoPrinceton University logoStanford School of Medicine logoUniversity College London logoORCID logo
  • University of Cambridge logo
  • Columbia University logo
  • Crossref logo
  • University of Edinburgh logo
  • Harvard University logo
  • University of Oxford logo
  • Princeton University logo
  • Stanford School of Medicine logo
  • University College London logo
  • ORCID logo

View CASRAI adoption →

Regulatory Radar

Stop finding out after the fact

$29/month, cancel anytime. Daily digest updates from our analysis, a dashboard holding the same items, and a cited assistant for everything they raise.

  • Federal Register, Federal Register+, Grants.gov, Regulations.gov, NSF News, UKRI, plus CASRAI’s own published content.
  • 44,322 indexed passages, and every answer cites the ones it drew on.