Broken Links in PDFs with Siteimprove

Addressing broken links in PDFs promptly is important in maintaining the quality of our content and creating the best possible experience for our users.

Broken Links in PDFs Report

Accessing the Broken Links in PDFs Report

The Broken Links in PDFs Report can be accessed from the Dashboard using the "Broken links in PDFs" button or through the Quality Assurance menu item (Quality Assurance > Links > Broken Links in PDFs).

Broken links in PDFs can be accessed from the dashboard (left) or the Quality Assurance menu (right).

Broken links in PDFs can be accessed from the dashboard (left) or the Quality Assurance menu (right).


Understanding the Broken Links in PDFs Report

From the Broken Links in PDFs Report, you will see a list of all broken links that occur in PDFs in your section, along with the number of PDFs the broken link occurs in, the date the broken link was first detected, and the reason the link is flagged as broken (HTTP status), as shown below.

Note! This report will show you broken links in any PDF that you link to from your section, regardless of if you are the owner of it!

The Broken Links in PDFs Report will show you a listing of all the broken links in PDFs linked to from your section, how many PDFs the broken link appears in,  the date the broken link was detected, and the reason for the broken link.

The Broken Links in PDFs Report will show you a listing of all the broken links in PDFs linked to from your section, how many PDFs the broken link appears in, the date the broken link was detected, and the reason for the broken link.


Viewing PDFs Affected by a Broken Link

To see a listing of the PDF(s) affected by a particular broken link, click on the number or down arrow in the PDFs column, as shown below.

View the PDFs affected by a broken link by clicking on the number or down arrow in the PDFs column.

View the PDFs affected by a broken link by clicking on the number or down arrow in the PDFs column.


Viewing Broken Links in a PDF

To see broken links in context in a PDF, click on the PDF title. This will bring you to the Document Report for that PDF. Broken links will be listed in the Issues panel at the side. Clicking on a broken link in this panel will show you which page(s) the link is broken on, whether the broken link is in the text or "from annotation" (described below), and outline the first occurrence of it in red, as shown below.

Clicking on the PDF title will open up a Document Report with broken links listed in the Issues panel.

Clicking on the PDF title will open up a Document Report with broken links listed in the Issues panel.


About the Broken Link

There are two ways that a link can be broken in a PDF; Siteimprove identifies these as "Text" and "From Annotation."

Text

A broken link from text simply means the readable URL on the page is a broken link. In most cases, if a link is broken from text, it is also broken "from annotation."

From Annotation

A link that is broken "from annotation" means that the URL of the link itself is broken.


Fixing Broken Links in PDFs

Fixing broken links in PDFs generally involves editing the original document that was used to create the PDF, converting the source document back to a PDF, and the uploading the new PDF over the existing one in the Media Library of T4.

Note: If your document contains full URLs for links, you will generally have to fix both the text and the "annotation." We recommend embedding links in the text itself, rather than using URLs as text.