QR codes in PDFs: provide an accessible route to the action

Make a QR code usable in a PDF by providing an equivalent direct route to its purpose, such as a meaningful text link and clear instructions. A person reading the PDF on the same phone they would use to scan it should not need a second device to continue. Readers using assistive technology also need to understand the destination without interpreting the visual pattern.

Start with the action the code represents

Imagine a fictional museum leaflet whose QR code opens a visitor booking page. The important information is the booking action, any relevant conditions, and how to reach it. 'QR code' describes the image type but does not explain the task. Write the surrounding text so the reader knows whether the destination books a visit, downloads a guide, or opens an audio description.

W3C's functional images tutorial explains that alternatives for functional images should communicate their purpose. Applying that principle to a QR-based action is an editorial design decision: make the destination understandable and provide a route that does not require scanning. The tutorial is general image guidance, not a QR-specific PDF certification rule.

Provide a meaningful digital link

Place a text link such as 'Book a museum visit' beside the code and make it lead to the intended destination. W3C technique G91 addresses link text that describes its purpose. Avoid a row of indistinguishable 'click here' links when several codes lead to different services.

Inspect the exported PDF link, not just the source text's blue underline. Test keyboard focus, activation, and destination. If the code image is also linked, consider how the image and nearby text are announced together so they do not create confusing duplicate actions. Choose image treatment according to whether it provides additional meaning, then inspect the actual PDF structure.

Write image alternatives in context

W3C technique PDF1 describes the PDF Alt entry for image alternatives. If the QR graphic remains meaningful content, its alternative should convey the relevant purpose rather than describe every square. If surrounding content already supplies the complete action and the graphic is redundant, review whether artifact treatment is appropriate for that specific presentation.

Do not assume that placing a raw URL in an image's alternative text creates an operable link. A reader still needs a usable action in the document. Likewise, do not mark every QR code decorative automatically: the surrounding text may omit a unique destination or instruction. Review the combined experience, including the link, graphic, label, and any conditions.

Plan for printed copies and destination changes

A digital hyperlink does not help someone holding a printed leaflet unless a readable address or another suitable route is also provided. Use a short, maintained address when your organization can support one, and verify that it leads to the same intended task as the code. Do not invent a shortened address or assume a third-party redirection service will remain available indefinitely.

Maintain a record of the code's destination, the visible link, the owner, and the publication revision. If the booking service changes, decide whether the existing route can be maintained or the publication needs replacement. A working scan that opens an obsolete event is a content failure even when every technical link still returns a page.

Test the full journey before release

1. Read the surrounding content without seeing the code and identify the intended action.
2. Use the digital PDF's text link with a keyboard in the intended viewer.
3. Scan a representative printed or displayed code and compare its destination with the text link.
4. Test the destination's essential task, including errors or sign-in where relevant, using controlled test details.
5. Confirm that a person unable to scan still has a usable route and knows what will happen next.

Record results for the exact publication rather than treating a successful scan of the source image as proof of the exported PDF. Compression, printing, layout changes, or a replaced destination can affect the experience. Use the PDF link guide for structural checks and the compression guide when preparing a smaller download.

Frequently asked questions

Sources

The statements above rest on the primary sources below. Where a source is a law or standard, the version and date named in the text are the ones checked on the review date. This guide is general information, not legal advice.

1. W3C WAI: Functional images . General principles applied to the QR-code workflow.
2. W3C G91: Descriptive link text
3. W3C PDF1: Image alternatives