How to Add a PDF Paper to Zotero Library
Add a paper PDF to your Zotero library, find the full text when you don't have it, and confirm the file attached to the right item.
You have a paper open, or a link to one, and you want it sitting in your Zotero library next to its citation details. This is where many people get stuck. The PDF lands in a downloads folder, or Zotero creates an entry with no file attached, and the paper is hard to find later.
Learning how to add a PDF to Zotero is simple once you have the file. The harder part is getting the full-text PDF in the first place, especially when Zotero's own lookup doesn't find one. This guide covers both: attaching a PDF you already have, and finding the paper's full text with the Zotero-connected literature workspace in the OmniDoc desktop client.
You will finish with the PDF attached to the correct item, a quick check that it opens and matches the citation, and a plan for scanned files that need OCR.
How to add a PDF to Zotero? The short answer
Make sure the paper exists as an item in Zotero, then attach the PDF to that item by dragging the file onto it or by using Zotero's option to add a file. If you don't have the PDF yet, find a legally available copy first, then attach it the same way.
| Your situation | What to do | Why |
|---|---|---|
| You already have the PDF on your computer | Drag the file onto the paper's item in Zotero | The file stays linked to the citation it belongs to |
| The item in Zotero has no file | Find a copy you are allowed to use, then attach it | The file sits with the item, so you can open it from your library |
| You don't have the full text | Use the literature workspace in the OmniDoc desktop client to find the PDF | It starts from the paper already saved in your Zotero library |
| The PDF is a scan | Run OCR in the OmniDoc PDF editor, then attach the saved copy | The text layer lets you search and highlight the paper |
| You are adding several papers | Attach each PDF to its own item and check each one | Mixed-up files are easy to miss when you add them in bulk |
Before you start
- Confirm you have the right version. Some papers exist as a preprint and a published version, and page numbers and wording can differ. Attach the version you cite.
- Check that the item exists in Zotero with correct details. A PDF attached to a blank or wrong entry is hard to match later, so fix the title, authors and year first.
- Use only copies you have the right to store. Good sources include the publisher's page, the author's own page, or your institution's library. Zotero keeps a copy of every attached file, so choose files you may keep.
- Install the OmniDoc desktop client if you want the workspace or the PDF editor. You can download it from download.omnidoc.top. The literature workspace and OCR tools are part of the desktop client, not the web page.
- Note where the PDF is saved. Knowing the folder saves time when you go looking for a file you downloaded earlier.
Adding a paper PDF to Zotero, step by step
- Open Zotero and find the paper's item. Search by title or author. Make sure you see the right entry before you attach anything, so the file doesn't end up on a duplicate.
- Compare the item's details with the paper. Check the title, authors, year and DOI against the first page of the PDF. A mismatch often means two entries exist for the same paper.
- Attach the PDF to the item. Drag the file onto the item, or use Zotero's option to add a file and pick the PDF. This keeps the file linked to the citation instead of leaving it loose in a folder.
- If you don't have the PDF, open the paper in the OmniDoc literature workspace. The workspace is connected to Zotero, so it can look for the PDF of a paper you have already saved.
- Save the PDF you find, then attach it the same way as in step 3. Review the file before attaching it, so you know it is the paper you want.
- If the PDF is a scan, run OCR in the OmniDoc PDF editor. OCR adds a text layer so you can search and highlight the paper. Save the result, then attach that copy to the item.
- Open the attachment from the item. Confirm the file opens inside Zotero and that the first page shows the paper you expect.
Check the result
Once the PDF is attached, check these four things.
| Check | How to see it | If it's wrong |
|---|---|---|
| The file is under the right item | Expand the item in Zotero and look for the PDF beneath it | Drag the PDF onto the correct item and remove any stray copy you created |
| The PDF opens | Double-click the attachment | Save the file again from its source; a damaged download won't open properly |
| The text is searchable | Search for a word from the paper, or try selecting a line of text in the PDF | If you can't select text, the file is a scan; run OCR in the OmniDoc PDF editor and attach the result |
| The details match | Compare the first page with the item's title, authors and year | Correct the item fields, or replace the PDF if it is a different version |
OCR output can contain errors, especially in formulas, tables and older scans. Check any text you plan to quote against the original page.
❓ FAQ
1. Why doesn't Zotero find the full text for my paper?
Zotero can only retrieve copies it can reach, and many papers have no freely available version. Check the publisher's page, the author's website or your library for a copy you are allowed to use, then attach it by hand.
2. Does attaching a PDF change the citation?
No. Attaching a file doesn't edit the item's title, authors or year. If those fields are wrong, correct them separately.
3. Can I add several PDFs at once?
Zotero can take more than one file at a time, but it may not match every file to the right paper. Check each new item afterward, and make sure its title and authors match the attached PDF.
4. Do I need the OmniDoc desktop client to use Zotero?
No. You can add PDFs to Zotero on its own. The OmniDoc desktop client adds the literature workspace for finding PDFs and the PDF editor for OCR on scanned files.
📝 Summary
To add a PDF to Zotero, attach the file to the correct item and check that it opens and matches the citation. When the full text is missing or the file is a scan, use the OmniDoc literature workspace or PDF editor before you attach it. A quick check now saves you from hunting for the right file later.


