'There was an error opening this document'
The message is famously unhelpful, and it covers at least six unrelated conditions ranging from a download that stopped early to a file that was never a PDF. Before assuming the document is lost, it is worth working through them in order of likelihood, because most are recoverable and the most common one takes thirty seconds to fix. This guide covers how to tell them apart and what each one needs.
A PDF's structure, briefly
Understanding one detail explains most PDF corruption. A PDF is a collection of numbered objects, and at the very end of the file sits a cross-reference table listing the byte offset of each one, followed by a pointer to that table and the marker %%EOF. A reader opens a PDF by jumping to the end first.
This is why a truncated download fails so completely. Lose the last few kilobytes and you have lost the index to everything else — the pages may be entirely intact and still unreachable. It is also why repair tools work: the objects can be found by scanning the file and a new cross-reference table rebuilt.
Work through these in order
| Check | How | If that was it |
|---|---|---|
| Is the file complete? | Compare the size against the source, or re-download | Download again, preferably on a stable connection |
| Is it actually a PDF? | Open in a text editor — a real PDF starts with %PDF-1.x | An HTML error page saved with a .pdf name is common; so is a renamed file |
| Is it encrypted? | Does any reader ask for a password? | You need the password, not a repair |
| Does another reader open it? | Try a browser, then a different application | The reader is the problem, not the file |
| Is it the reader's cache or a plugin? | Try a private window or a different machine | Clear the cache; some browser PDF extensions break on large files |
| Does a repair recover it? | Run Repair PDF | The cross-reference table was damaged and has been rebuilt |
The text editor check is worth doing early because it is instantaneous and decisive. A PDF begins with %PDF-. If the first characters are <!DOCTYPE html, what you downloaded was a login page or an error page. If they are PK, it is a ZIP-based file such as a DOCX with the wrong extension.
What repair can and cannot do
Repairing means scanning the whole file for object definitions, rebuilding the cross-reference table from what is found, and writing a fresh document. Repair PDF does this in the browser.
- Usually recoverable: a damaged or missing cross-reference table, a broken incremental save, a file written by software that produced slightly invalid structure, stray bytes prepended by a mail gateway.
- Partially recoverable: a truncated file. Everything before the cut can often be recovered, so a 200-page document might come back with 180 pages. That is frequently enough.
- Not recoverable: an encrypted file without its password, a file whose object data itself is corrupted rather than its index, and a file that was never a PDF. No tool invents missing bytes.
When it opens but behaves badly
A separate class of problem, with separate causes:
- Blank pages. Often a font or transparency the reader cannot render. Try a different reader before concluding the pages are empty. If one reader shows content and another does not, the file is fine and the reader is at fault.
- Wrong or missing characters. A font was referenced but not embedded, so the reader substituted one. Embedding at export time prevents it; there is no reliable fix afterwards.
- Extremely slow. Usually enormous images, deeply nested transparency, or thousands of vector objects on one page. Compressing the document generally fixes it.
- Opens on one machine, not another. Almost always a reader version difference rather than the file.
- Prints wrong but looks right. Transparency handled differently by the printer driver. Flatten before printing.
Avoiding it next time
Most damaged PDFs are damaged in transit or in storage rather than at creation. Download large files over a stable connection and check the size against what the source advertised. Do not edit a PDF that is still syncing in a cloud folder, which is a reliable way to produce a half-written file. Keep the source document — a PDF regenerated from its Word or design original is always cleaner than a repaired one. And when you receive a PDF that matters, open it once on arrival rather than discovering a year later that it never worked.