# PDF Specification Issues
Get your [sponsored copy of ISO 32000-2 or PDF/UA-2 now](https://pdfa.org/sponsored-standards/)! Includes industry and ISO-approved errata and various ISO PDF 2.0 extensions.
## Stats
## About
This public GitHub repository is hosted by the [PDF Association](https://www.pdfa.org) and
provides every stakeholder a means of openly reporting errata against any PDF specification, including ISO publications and certain PDF Association industry specifications. Errata are resolved via consensus in PDF Association [Technical Working Groups](https://pdfa.org/community/) (*open to members*) and published at [https://pdf-issues.pdfa.org/](https://pdf-issues.pdfa.org/). For ISO publications, these industry resolutions are passed to the [relevant ISO working group](https://www.pdfa.org/iso-status/) for later ratification.
All issues in PDF specifications are important, from minor typos and formatting issues, to
larger ambiguous, unclear or apparently contradictory statements. By reaching consensus on resolutions as an industry,
PDF interoperability and implementation reliability can be improved.
The current set of resolved errata are presented as
additions,
deletions or
Editor Notes
to the published wording in the relevant ISO standard organized by clause number.
GitHub Issue numbers will appear as popup tooltips when hovering over changes and refer back to
closed GitHub pdf-issues.
* If a small blue ISO logo is also shown , then that errata has been approved by both the PDF Association's appropriate TWG and the appropriate [ISO working groups responsible for PDF](https://www.pdfa.org/iso-status/).
* If a small gray ISO logo is also shown , then that errata has been approved by the PDF Association's appropriate TWG and submitted to the appropriate ISO working group and is waiting for approval.
* If no ISO logo is shown then the errata has been resolved by a PDF Association [Technical Working Group](https://www.pdfa.org/community/) but has not yet been submitted to ISO for ratification.
Due to ISO copyright, only minimal surrounding text from the relevant ISO publication is provided that is sufficient to understand where the resolution is being applied.
Errata in the following PDF specifications are supported:
### Core PDF technologies
### PDF/A (ISO 19005) - PDF for long-term preservation
* PDF/A-4 (ISO 19005-4:2020) - *Resolved errata*
* PDF/A-3 (ISO 19005-3:2012) - see TechNote 0010
* PDF/A-2 (ISO 19005-2:2011) - see TechNote 0010
* PDF/A-1 (ISO 19005-1:2005) - see PDF/A-1 Technical Notes and TechNote 0010
### PDF/X (ISO 15930) - PDF for prepress digital data exchange
* PDF/X-6 (ISO 15930-9:2020) - *Resolved errata*
* PDF/X-5 (ISO 15930-8:2010)
* PDF/X-4 (ISO 15930-7:2010)
* PDF/X-3 (ISO 15930-6:2003)
### PDF/VT (ISO 16612) - PDF for variable data & transactional printing
* PDF/VT-3 (ISO 16612-3:2020) - *Resolved Errata*
* PDF/VT-2 (ISO 16612-2:2010)
### PDF/UA (ISO 14289) - PDF for universal accessibility
* PDF/UA-1 (ISO 14289-1:2014)
* PDF/UA-2 (ISO 14289-2:2024)
### Other ISO PDF publications
* PDF/R-1 (ISO 23504-1:2020)- PDF for raster image transport and storage
Errata on PDF 1.7 (ISO 32000-1:2008) and withdrawn ISO publications are **not** supported - refer to ISO 32000-2 instead.
The PDF Association maintains a [full list of all PDF-related ISO publications](https://www.pdfa.org/index-of-pdf-related-iso-publications/).
Not all resolutions proposed here are officially authorized by the [ISO working groups responsible for PDF](https://www.pdfa.org/iso-status/) and may get changed when reviewed by the ISO working group.
## A Simple Process
1. Open a new GitHub Issue. Clearly explain the mistake you have found in a PDF specification, or the feature you would like to see in a future version.
2. The community can discuss and contribute to open issues here in GitHub, and work towards a proposed resolution.
3. The PDF Association's [PDF Technical Working Group](https://www.pdfa.org/community/pdf-technical-working-group/) (TWG) will consider all input and reach a consensus for each proposed resolution. Issues related to PDF subset standards or specific technical topics may get delegated to other TWGs.
4. Each issue will be updated with the agreed resolution and then Closed by moderators once the resolution is published at [https://pdf-issues.pdfa.org/](https://pdf-issues.pdfa.org/).
5. At some later time, errata will be passed to the appropriate ISO working group for formal ratification.
A full list of all ISO and industry-agreed issue resolutions (as pseudo-markup) is actively maintained at [https://pdf-issues.pdfa.org/](https://pdf-issues.pdfa.org/).
## Directly referencing resolutions
Errata can always be referred by the appropriate GitHub issue numbers(s). Resolutions are published to a set of static URLs at [https://pdf-issues.pdfa.org/](https://pdf-issues.pdfa.org/) of the form `/clause.html`. Each of these resolution pages also includes anchor points for all Headings (`#Hx.y.z` anchors to heading X.Y.Z in the appropriate ISO standard) and Tables (`#TableXXX` anchors to Table XXX in the appropriate ISO standard). This allows very precise linkages to final resolution outcomes, without scrolling through long technical GitHub discussions.
For example:
* [https://pdf-issues.pdfa.org/21757-1-2020/](https://pdf-issues.pdfa.org/21757-1-2020/) links directly to every resolution in ISO 21757-1:2020 ECMAscript for PDF 2.0.
* [https://pdf-issues.pdfa.org/32000-2-2020/clauseAnnexQ.html](https://pdf-issues.pdfa.org/32000-2-2020/clauseAnnexQ.html) links directly to all resolutions in Annex Q *(normative) Method for determining transparency on a page* of ISO 32000-2:2020 (PDF 2.0).
* [https://pdf-issues.pdfa.org/32000-2-2020/clause12.html#H12.5.6.5](https://pdf-issues.pdfa.org/32000-2-2020/clause12.html#H12.5.6.5) links directly to all resolutions in ISO 32000-2:2020 (PDF 2.0) clause 12.5.6.5 *Link annotations*.
* [https://pdf-issues.pdfa.org/32000-2-2020/clause08.html#Table87](https://pdf-issues.pdfa.org/32000-2-2020/clause08.html#Table87) links directly to all resolutions in ISO 32000-2:2020 (PDF 2.0) Table 87 - *Additional entries specific to an image dictionary*.
## Legal
In contributing to this GitHub repository, you acknowledge that all content you share may be reproduced in whole or in part in future PDF Association publications, ISO standards or other deliverables. It is your responsibility in submitting such content to ensure that the agreement of any copyright holder has been obtained. More information about [ISO contribution processes can be found here](https://www.iso.org/publication/PUB100037.html).