Why Won’t My PDF Open?

A PDF that refuses to open is almost always suffering from one of four problems: the file is corrupted, it is password-protected, it was saved in a PDF version your viewer does not support, or the download was truncated. Each cause has a different fix. This guide walks through how to tell which one you are hitting and what to do about it — using local tools that do not upload your document.

The 4 common causes

1. The file is corrupted

Corruption means the PDF's internal structure is broken — the cross-reference table, object streams, or trailer are missing or inconsistent, so a reader cannot locate the pages. Symptoms include a blank window, an error like "The file is damaged and could not be repaired," or a viewer that opens the first page but crashes when you scroll. Common causes: a bad download, a crash during the original export, a disk write that was interrupted, or an email gateway that stripped bytes.

How to check: look at the file size. A 0-byte file or one noticeably smaller than expected is corrupted. Open it in a text editor — a valid PDF starts with %PDF-1. followed by a version number and ends with %%EOF. If either marker is missing, the file is structurally broken.

Fix: restore from backup or re-export from the source application. If you do not have a backup, seeHow to Repair a Corrupted PDF— but be aware that repair is not always possible, and IXPDF cannot do it (AGENTS.md §16).

2. The file is password-protected

A PDF encrypted with a user password cannot be opened without the key. Viewers show a password prompt, not an error. If you do not know the password, no legitimate local tool will bypass strong AES-256 encryption in a reasonable time — that is the point of encryption.

How to check: open the file in Adobe Acrobat Reader or macOS Preview. If you get a password prompt, the file is encrypted.

Fix: if you have the password, open the file and re-save it without encryption. On macOS, open in Preview, thenFile > Export… and untick Encrypt. On Windows, open in Adobe Acrobat Pro, then File > Save As withStandard security (no password). From the command line,qpdf --decrypt input.pdf output.pdf removes the encryption when you supply the password. If you do not have the password, see How to Unlock a PDF for the honest legal and technical limits.

3. The PDF version is unsupported

PDF is a versioned standard. A file marked %PDF-2.0 or using features introduced in PDF 1.7 Extension Level 8 may not open in older viewers. Symptoms vary: some viewers refuse to open the file, others open it but render features incorrectly (missing 3D models, broken JavaScript, blank form fields).

How to check: open the file in a text editor and read the first line. %PDF-1.7 is widely supported;%PDF-2.0 requires a modern viewer (Adobe Acrobat Reader DC 2019 or later, Preview on macOS 10.14 or later).

Fix: open the file in a current version of Adobe Acrobat Reader (free) and re-save it. Acrobat will flatten newer features into a broadly compatible PDF 1.7 file. If you do not have Acrobat, qpdf --input-version=1.7 input.pdf output.pdfdown-converts the version marker without re-rendering.

4. The download was truncated

A truncated download is the most common cause of "won't open" for files received by email or pulled from a website. The file looks complete in your file manager but is missing the trailing bytes — including the%%EOF marker and the cross-reference table — so no viewer can find the pages.

How to check: compare the file size to the size the sender or website reported. If your file is smaller, the download was truncated. Open the file in a text editor and scroll to the end — a valid PDF ends with %%EOF. If the file just stops in the middle of object data, it is incomplete.

Fix: re-download the file. If the source is an email attachment, save it to disk first, then open the saved copy. If the source is a website, try a different browser or use a download manager that verifies byte counts.

Quick diagnostic checklist

1. Try a different viewer. Open the file in Adobe Acrobat Reader (free) or macOS Preview. If it opens, your original viewer was the problem, not the file.
2. Check the file size. A 0-byte or suspiciously small file is corrupted or truncated. Re-download or restore from backup.
3. Look for a password prompt. If the viewer asks for a password, the file is encrypted — that is not corruption.
4. Inspect the first and last bytes. Open in a text editor. The file should start with %PDF-1. and end with%%EOF. Missing markers mean structural damage.
5. Check the PDF version. If the first line says%PDF-2.0 and your viewer is old, upgrade the viewer or re-save as 1.7.

Which viewer to try first?

When a PDF will not open, the viewer is sometimes the problem, not the file. Browser-based viewers (Chrome, Firefox, Edge) are fast but reject files with non-standard features. Try a dedicated PDF reader before concluding the file is broken.

• Adobe Acrobat Reader (free, Windows and Mac). The most tolerant viewer. If a PDF opens anywhere, it usually opens here.
• macOS Preview (free, Mac). Fast and good for most files. Weaker than Acrobat on forms and 3D content.
• Firefox PDF Viewer (free, cross-platform). Uses PDF.js. Strict — rejects files with structural errors that Acrobat silently repairs.

Common mistakes

• Assuming the file is corrupted when it is just encrypted. A password prompt is not an error. Try the password before concluding the file is broken.
• Uploading the file to an "online PDF repair" service.If the file contains sensitive content, you have just sent it to a stranger's server. Use a local tool.
• Trying to open the file in Word or Google Docs.These are not PDF viewers — they convert the file, and conversion fails on damaged input. Use a real PDF reader.
• Deleting the file immediately. Keep the broken copy until you have a working one. A partial repair may be possible, and the original is your only evidence of what went wrong.