Cross-Reference Table

Definition

A PDF is a pile of numbered objects scattered through the file, and the cross-reference table — the xref — is the index that says where each one starts. A reader opens a PDF by reading the trailer, jumping to the xref, and using it to locate everything else. If the xref is damaged or missing, the reader cannot find the pages even when the page data itself is intact, which is how a file ends up “broken” while its bytes are all still there.

Example

A file that arrives with a truncated tail after a bad transfer. The pages are present in the file, but the index is gone, so readers refuse to open it. A repair pass rebuilds the index by scanning for objects directly, and the document opens again with every page in place.

In the PDFLean tools

• repair a damaged PDF — structural health check, deep repair, and page rescue
• inspect a PDF file — reports structural facts about the file in one pass

Related reading

• Incremental Update — how the index grows with every save
• Page Content Stream — the objects the index points at
• Troubleshooting — what to do when a file will not open