Clearly labeling PDFs, downloads, and external links

How to label PDFs, downloads, and external links in a clear and accessible way?

The link text names the specific document or external target in a way that remains understandable even outside the paragraph. File type, language, size, or whether it opens in a new window are only added if this information actually influences the decision to open the document.

Descriptive link target

• Descriptive link target The link text names the document or external target in a way that remains understandable even outside the surrounding paragraph.

• Relevant format information File type, language, size, or whether it opens in a new window are only added if they actually influence the decision to open the document.

• Consistent labeling Recurring download and external link patterns use visible text and symbols according to the same editorial and technical rules. ... : : : : : : : : : : : : : : :

Icon without a name

• Icon without a name – An arrow or PDF icon displays all the target information, but remains blank for assistive technologies or is read aloud without meaning.

• Warning noise – Every external link announces a new window or external domain, even though this behavior is normal and not surprising.

• Unclear download version – Several files with the same name differ in language, time period, or version, without these characteristics being reflected in the link text.

Relevant format information

1. Inventory download and external links and determine the information actually required for each target before activation.

2. Create link text from the document title and relevant attributes; hide decorative icons and provide accessible, informative text.

3. Check patterns in lists, body text, and buttons linearly and with the keyboard, and editorially clean up outdated file names.

Diagnostic case: "Icon without a name"

A page links three times with "Download PDF" to different annual reports. The links are specified as "Annual Report 2025, German, PDF" and "Annual Report 2024, English, PDF". The file icon remains decorative, and a new window indicator only appears where the browser path actually deviates.

Consistent labeling

• Percentage of verified downloads whose link text clearly names the content and necessary format or version information without image context.

• Number of external or file-based destinations where the icon, visible text, and accessible name create different expectations.

How "Clearly Name Downloads and External Links" relates to other topics

An in-depth question answered Making focus states visible without distorting the designHow to integrate highly visible focus states into a design system?

Further Perspectives Planning Contextual Links Between Performance and Advice Pages.

If you want to implement "Clearly Name Downloads and External Links" in practice, you can refer to Robust Website Systems . The focus there is on "Labels, Language, and Content Alternatives" and "Descriptive Link Target."

Conclusion: Clearly name downloads and external links

Labeling should enable an informed decision before opening, not announce every technical detail. Precise link text is more effective than a collection of ambiguous icons.

Sources and Further Information

The following official documentation and standards provide the technical classification.

• Technique G201: Warning When Opening a New Window — W3C WAIThe W3C technique describes the visible and programmatically detectable warning for links that open a new window or tab.

• Understanding Link Purpose (In Context) — W3C WAIThe explanation for WCAG 2.4.4 states why users must be able to recognize the target and purpose of a link from its text or clearly associated context.

• Technique H30: Descriptive Link Text — W3C WAIThe WCAG technique requires a clear link purpose and explicitly shows how file formats such as PDF or Excel can be indicated in the link text.