Use the Content Toolkit
Use the Link Checker
📌 Requirements: Pressbooks Enterprise network with the Content Toolkit enabled. This tool is not available on Pressbooks Self-Publisher (pressbooks.pub).
The Link Checker allows you to easily locate all broken or unreachable links within your book, so that you can know exactly which links to fix to ensure a smooth experience for your readers.
Check Links
If your network has the Content Toolkit enabled and you have the user role of Administrator in a book, you’ll see an option in the left sidebar of your book dashboard, Content Toolkit > Link Checker. Navigating there will bring you to an interface where you can request a new scan or view the results of the most recent scan for broken links in your book.
To run a scan, click the Start Scan button. The tool will then comb through your book, systematically checking every link. While the scan is running, you can leave the page and return later. You can also opt to receive an email when the scan has completed.
Understand the Report
Once the scan completes, a report will appear on the Link Checker page. You can view it here or click the Download Report (CSV) button to download the report as a CSV file.
The report lists all broken or unreachable links in your book in the order in which they appear. For each listed link:
- The Page column shows the book chapter, front or back matter where the broken link was found (you can click to navigate there directly).
- The Link column shows the broken link itself.
- The Link Text column shows the text, in your book, that points to the broken link.
- The Status column shows the HTTP status code that was returned when the link checker attempted to navigate to the link.
- The Description column defines the status code or issue encountered when attempting to navigate to the link.
Common status codes:
- 401: the resource you’ve linked to requires login or authentication in order to be viewed,
- 404: the page doesn’t exist at the given address,
- -1: no site was found at the linked location.