How to find broken links in Confluence
Updated
To find broken links in a Confluence Cloud space, use a link checker app such as Linktally: open Link checker in the space sidebar and you get every link on the space's pages that points at a deleted, trashed or never-created page, a renamed heading, a missing file or a deleted space, each with what to do next. Relink then points every link to a replaced page at the new one, with a preview first and undo after.
Steps
- Install Linktally. A full scan of your site starts right away. Most sites finish within minutes, large ones within a few hours; progress is under Confluence administration > Apps > Linktally links.
- Open Link checker in the space's sidebar.
- Filter by problem or export the whole list to CSV.
- Fix each row, or relink in bulk (below).
What counts as a broken link
| Problem | Meaning | What to do |
|---|---|---|
| Page deleted | The linked page no longer exists | Relink to the page that replaced it, or remove the link |
| Page in trash | The linked page is in its space's trash | Restore it, or relink |
| Page does not exist | A link to a title nobody created | Create the page, or relink |
| Attachment missing | A linked or embedded file is gone | Upload it again, or remove the link |
| Space does not exist | A link to a deleted space | Remove or change the link |
| Anchor not on page | A link to a heading that was renamed or removed | Edit the link, or rename the heading back |
| Points at old site | A link to your former Data Center or Server address | Fix old site links |
Only links to your own Confluence site are checked. Links to other websites are never visited.
Fix links to a replaced page in one go
After a page is deleted, merged or replaced, every page that linked to it needs the new link.
- Choose Relink on a row, or open the Relink tab and paste the old page's link.
- Paste the new page's link, and choose every space or this space only.
- Preview lists every page that will change and how many links on each.
- Change N pages applies it. Each page gets a normal new version, made as you.
- Undo puts every page back, except pages someone edited since. History and Undo last 90 days.
See which pages link to a page
Before you delete or rename a page, check what links to it. Every page byline shows N incoming links, and the Incoming links macro lists every page and blog post that links here, grouped by space. Page links, pasted URLs, smart links, heading links and short links all count. Each reader sees only pages they can open.
After a migration from Data Center or Server
Add your old address (for example wiki.example.com) in Linktally's settings and run a full scan. Fix old site links in each space then previews and changes links that name a page into links to the page with the same title on Cloud. Links by old page id are listed for you to fix by hand.
What it costs
Linktally is $7 a month for up to 10 users, or $70 a year. From 11 users it is $0.70 per user a month, with lower rates for larger sites. It is billed by Atlassian, with a 30-day free trial.
Linktally: Incoming and Broken Links for Confluence
See every Confluence page that links to a page, find every broken link in a space, and fix links in bulk with a preview and undo. From $7 a month for up to 10 users.
See LinktallyQuestions
Does Linktally check links to other websites?
No. It checks links to pages, files and spaces on your own Confluence site.
Do links from Jira count?
No. Linktally indexes Confluence pages and blog posts.
Who can relink pages?
Space admins in their spaces and Confluence admins, by default. A Confluence admin can let anyone who can edit the pages relink.
Does anything leave Atlassian?
No. Linktally runs on Atlassian's Forge platform and keeps its link index in your site's Forge storage.