Broken links
Find links and images in your topics that no longer work, fix them, and hide the ones you've checked.
Sonat checks the links in a topic each time you save it: links to web pages, links to other topics and images. A link that stops working is marked Broken. The Reference links page lists them all in one place.
Open Reference links
- For the whole organization, open Content Tools in the left menu and select Reference Links. For one document, open the document and go to More actions › Reference Links.
- Look at the three tiles at the top: Total reference links, Broken and Ignored.
- Select the Broken tile to show only broken links.

The broken-link count also appears on the Analytics page, in Needs your attention and on the Content health tab. Review links there brings you here.
Narrow the list
- Outbound or Inbound: links that go out from your topics, or links that point to a topic.
- Status: Any status, Broken or Valid.
- Type: URL, Topic link or Image.
- Document: in the organization view, pick one document.
- Search by title, address or document.
- Show ignored: include links you've ignored.
Each row shows where the link is (From topic), the Target, its Type, Language, Status and when it was Last checked. Hover over a Broken tag to see the error the check got.
Fix a broken link
- In the row, select Open in editor. The topic opens.
- Find the link and update or remove it.
- Save the topic. Sonat checks the link again.
- Publish the topic so readers get the fix.
Ignore a link you've checked
Some links work for people but fail an automated check, for example a page behind a login. To stop counting one as broken:
- In its row, select Ignore.
- To bring it back, turn on Show ignored and select Restore.
Check all links again
Select Re-scan all at the top of the page. The check runs in the background and the list refreshes over the next minute.
See links for the topic you're editing
- In the editor, open the Reference links tab in the side panel, or choose References Panel in the topic's options menu.
- Review the topic's outbound links and which topics link to it.
A red broken-link icon next to a topic's title also tells you the topic has broken links. Select it to open the Reference links page for that topic.
If something goes wrong
A link works in my browser but shows Broken
The site may have been down during the check, or it may block automated visits. Select Re-scan all. If it's still broken and you're sure it works, select Ignore.
I fixed a link but it still shows Broken
Save the topic so Sonat checks it again, then refresh the page.