Content guide - Links

How to handle links, including links to PDFs

Write good links

Make links active, specific and concise.

Links should describe where they're taking the user. Where you can, use the same words as the title of the page you're linking to. That way, the user will know what to expect.

We do not use link text such as "click here" or anything that does not make sense when read out of context. Screen readers can move between links without reading the surrounding content.

We would use:	We would not use:
symptoms of asthma	symptoms
more about asthma	more information

Avoid opening new windows or tabs

Avoid using links or buttons that open new windows or tabs.

There are 2 exceptions to this:

for instructions or other help with filling in a form (for example, a date picker)
if a user has logged into a secure site and the link would take them away from it

If links do go to a new tab or window, warn the user by saying: "Link name (opens in new window)". (Include all of this in the link text.)

Avoid linking to PDFs

Wherever possible, we avoid publishing PDFs or linking to them. Read our guidance on PDFs and other non-HTML documents.

We prefer to link to an HTML page containing the PDF. That way, if the PDF is changed or updated, users can still find the latest information.

If we need to link to a PDF, we:

open it in the same tab
add "PDF only, [file size in MB or KB]" in brackets to the end of the link text, for example: "weight loss progress chart (PDF only, 545KB)"

Round up values over 1MB to 2 decimal places to keep it as accurate as possible.

Round up values under 1MB to the nearest KB. For example, round up 835.74KB to 836KB.

Help us improve this guidance

Share insights or feedback and take part in the discussion. We use GitHub as a collaboration space. All the information on it is open to the public.

Feedback or share insights on GitHub

Read more about how to feedback or share insights.

If you have any questions, get in touch with the service manual team.

Updated: January 2022