Dictionary

What Is The PDF Version?

The PDF Version is the number of the PDF standard a document follows, such as 1.4, 1.7, or 2.0. Every PDF file states it in its first line.

pdf-version

The PDF Version is the version number of the PDF standard that a document follows. It shows which edition of the PDF rules applies to the file, for example 1.4, 1.7, or 2.0.

PDF stands for Portable Document Format. Adobe published the first version, PDF 1.0, in June 1993. Each new version added features, and since 2008 the PDF format has been an ISO standard.

Where the value comes from

Every PDF file starts with a short header in its first line. The header is a percent sign, the letters PDF, a hyphen, and the version number. For a version 1.7 file, the header ends in PDF-1.7.

From PDF 1.4, a file can also store its version in the document catalog, in an entry called Version. The number in the header applies unless this entry names a later version. The rule helps a program that saves changes by adding them to the end of an existing file.

For this reason, the header and the catalog can show different numbers. The Library of Congress describes a file with version 1.3 in its header and 1.4 in its catalog. In such a file, the catalog value is the one that applies.

A PDF can repeat its version in the XMP metadata as well. The XMP specification defines the field pdf:PDFVersion for this and describes it as the PDF file version.

How the versions differ

The value has a major version number and a minor version number, with a point between them. Adobe created versions 1.0 to 1.7, and an ISO committee developed version 2.0. The versions are:

  • 1.0: June 1993, together with Acrobat 1.0
  • 1.1, 1.2, and 1.3: published between March 1996 and July 2000
  • 1.4: November 2001, with XMP metadata and tagged PDF
  • 1.5: August 2003, with support for JPEG 2000 images
  • 1.6: November 2004, with 3D data in the U3D format
  • 1.7: November 2006, published as the ISO standard ISO 32000-1 in July 2008
  • 2.0: the ISO standard ISO 32000-2, published in July 2017 and revised in December 2020

Adobe added later features to PDF 1.7 as extension levels, not as a new version number. Files with these features still carry the base version number 1.7.

Which files carry it

Every PDF document has a PDF Version, because every PDF file starts with the header. The media type application/pdf and the file extension .pdf are the same for all versions. The file name therefore does not show the version.

Some special kinds of PDF are based on one version of the standard. The archive format PDF/A-1 is based on PDF 1.4, PDF/A-2 and PDF/A-3 on PDF 1.7, and PDF/A-4 on PDF 2.0. A PDF/A-2 or PDF/A-3 file can still state a lower number than 1.7 in its header.

Why it matters

The PDF Version tells you which edition of the rules the file follows. That edition decides which features the file can use.

PDF adds new features in a way that older viewers can usually handle without breaking. The standard asks a reader to try to open every PDF file, even a newer one. Parts that use newer features may then be missing or look wrong.

A lower version works in more programs. RFC 8118 registers the PDF media type. It says that the older the PDF version, the more older viewers support it.

The version also changes the rules for some metadata. PDF 2.0 marks most entries of the older document information dictionary as deprecated, so PDF 2.0 files should not use them. This includes the title and the author, but not the creation date and the modification date.

The PDF Version holds no personal information about you. It only names the edition of the PDF standard that the file follows.