> ## Documentation Index
> Fetch the complete documentation index at: https://help.milton.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Import from Zotero

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](https://mintcdn.com/milton-help/kiy3RmS7wYTX7rS6/images/zotero-settings-connect.png?fit=max\&auto=format\&n=kiy3RmS7wYTX7rS6\&q=85\&s=4bebe75664a2af6c8463cc350c6257dc)

You can also connect during setup, at the **Connect Zotero to Milton** step.

> [!TIP]
>
> Prefer an API key? Click **Use an API key instead** and paste a key created at [zotero.org/settings/keys](https://www.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.

> [!WARNING]
>
> 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.