Alternative description missing for an annotation

PAC 2 Error

Alternative description missing for an annotation


PDF/UA > Logical Structure > Alternative Descriptions > Alternative descriptions for annotations

Failure Condition

Matterhorn Protocol Checkpoint 28-012: A link annotation does not include an alternate description in the Contents Key.


In the PAC 2 test report, click the error to see the location of the link in the document. In the Tags pane in Acrobat Pro, right-click the Link tag and select Properties. On the Tag tab of the Object Properties dialog, click the Edit Tag button. In the Tag Element dialog, expand items and drill down to the “/Obj <<Dictionary>>” item (I usually find it under “/K [Array]”; then “[0] <<Dictionary>>”.  Select “/Obj <<Dictionary>>” then click the New Item button. In the Add Key and Value dialog, enter Contents in the Key field, change the Value Type to String, and enter a meaningful alternate description in the Value field. For external links, a good practice is to use a description that matches the Title property of the target page. For internal links such as those in a Table of Contents, it may make sense to simply use the text of the link itself.

Note: In the case of a link that is split across a line break such that there are two Link-OBJR objects nested under the Link tag, you should find two  “[#] <<Dictionary>>” items, each with a “/Obj <<Dictionary>>”, both of which will need a Contents key with an alternate description.

Example PDF with this error

Video version of this suggestion: