> ## 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.

# Add a reference

## Open the Add reference window

Any of these works:

* Press **Mod + N** (⌘N on macOS, Ctrl+N on Windows and Linux).
* On the **References** page, click **+ add**.
* When your library is empty, click **+ add references**.

![The top of the References page, with + add](https://mintcdn.com/milton-help/CQbZfUaauwZBJQyI/images/add-reference-button.png?fit=max\&auto=format\&n=CQbZfUaauwZBJQyI\&q=85\&s=cc149fe6a96b28fca37004253bf36e1d)

## From a DOI or a PDF link

1. In the **DOI or PDF link** tab, paste one of:

   * a DOI, like `10.1086/259717`, or a `doi.org` link

   * a direct link to a PDF file

   * for an arXiv preprint, its arXiv DOI, like `10.48550/arXiv.1706.03762`. An arxiv.org link or a bare arXiv ID isn't recognized.
2. Milton looks it up by itself (or click **Preview**). A preview shows the authors, date and abstract.
3. To correct something, click **Edit details**.
4. Optional: add **Tags** and set the **Importance**.
5. Click **Import**.

When you paste a PDF link, Milton downloads the PDF and reads the details from it. If it says "Metadata from PDF (best-effort — please verify)", check the details before importing.

![The Add reference window, DOI or PDF link tab, with a preview of the reference](https://mintcdn.com/milton-help/CQbZfUaauwZBJQyI/images/add-reference-doi.png?fit=max\&auto=format\&n=CQbZfUaauwZBJQyI\&q=85\&s=ae94f4347f5c5015af64d1b8fc333890)

## From scratch

1. Click the **From scratch** tab.

2. Choose the type (Article, Book, Book Chapter, Conference Paper, Thesis, Preprint, Report, Website or Other) and fill in the **Title** and any other details.

   ![The From scratch tab with the type set to Article and the title and authors filled in](https://mintcdn.com/milton-help/CQbZfUaauwZBJQyI/images/add-reference-from-scratch.png?fit=max\&auto=format\&n=CQbZfUaauwZBJQyI\&q=85\&s=e7d3118d3fa769e66790a337a4564a70)

3. To attach a PDF from your device, click **Select PDF**.

4. Click **Create reference**.

The date field understands "2024", "March 2024", "2024-03-15" or "15/03/2024".

## Milton finds the PDF for you

When you add a reference with a DOI but no PDF, Milton looks for a free (open-access) version and attaches it if it finds one. If it doesn't, open the reference's **PDF** tab later and click **Try to find PDF automatically**, or **Attach PDF** to add your own.

## Already in your library?

If the reference is already there, Milton says "This reference is already in your library" and tells you whether it matched by DOI, title or PDF filename. Milton doesn't create duplicates.

> [!NOTE]
>
> Milton can't look up books by ISBN. Use **From scratch** and type the ISBN in its field.

## Other ways to add references

* [Import from Zotero](https://help.milton.so/references/import-from-zotero.md)
* [Import a BibTeX or RIS file](https://help.milton.so/references/import-bibtex-ris.md)
* [Save from your browser](https://help.milton.so/references/browser-extension.md)


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