Skip to main content
Milton imports your Zotero library through your zotero.org account. Nothing is ever written back to Zotero.

1. Connect Zotero

  1. Go to Settings → Zotero integration.
  2. Under Connect to Zotero, click Connect.
  3. Your browser opens zotero.org. Sign in if needed and accept the connection. Milton asks for read-only access.
  4. Go back to Milton. It shows the connection as done.
Settings, Zotero integration, with Connect under Connect to Zotero
You can also connect during setup, at the Connect Zotero to Milton step.
Prefer an API key? Click Use an API key instead and paste a key created at zotero.org/settings/keys.

2. Import your library

  1. In Settings → Zotero integration, under Import or re-import my Zotero library, click Import. (When your library is empty, you can also click Import from Zotero on the References page.)
  2. In Import references from Zotero:
    • The References tab lists your items. Use Select all or tick the ones you want.
    • The Folders tab lists your Zotero collections. Each folder you tick becomes a Milton project.
  3. Click Import.
Small imports finish in the window. Larger ones continue in the background, with a progress card in the sidebar: references first, then PDFs, then notes. You can keep working. To stop an import, cancel it and choose Keep imported (keep what’s done), Undo all or Continue importing.

What comes over

  • All the bibliographic details, and the date you added each item
  • The first PDF of each item, including linked files and ZotFile PDFs. PDFs synced through WebDAV come over only if Zotero has already downloaded them to your device.
  • Child notes, added to the reference’s notes under “Note imported from Zotero”
  • Highlights and underlines, with their colour and comment
  • Zotero’s Extra field, as a custom property called “Extra”
  • Group libraries, as projects
Not imported: standalone notes, attachments after the first PDF, and images inside notes. When the import ends, Milton tells you about PDFs it couldn’t bring over (for example “not found where Zotero links them”, “not downloaded by Zotero (WebDAV)”, or “skipped (over 500 MB)”).

Import again later

Run the import again any time. Items already in Milton are marked Already in library. Re-importing never duplicates them and never changes details you edited: it only fills empty fields and adds missing PDFs, notes and highlights.
If you quit Milton during an import, it stops. Run it again: it picks up the items that are missing.

Add one Zotero item at a time

In Settings → Zotero integration, turn on Show in “New reference” modal. A Zotero tab then appears in the Add reference window, where you can search your Zotero library and import single items.

Disconnect

In Settings → Zotero integration, click Cancel next to the connection. Your imported references stay in Milton.
Last modified on November 21, 2026