Support Log in
All Features: WordPress SEO Plugin with AI Tools

WordPress Broken Link Checker — Background Scanning

Rank Forge scans the links in your published posts and pages and lists the ones that return an error. You start the scan yourself on the Broken Links tab of the Tools screen, and it runs in the background, so you can leave the page while it works. The scanner is part of the free plugin and needs no licence.


Why broken links hurt SEO

Broken outbound links leak PageRank, frustrate users, and signal to Google that your content isn’t maintained. Broken internal links are even worse — they create orphan pages, break navigation paths, and damage the internal linking structure that Google uses to understand your site’s hierarchy.

On a mature WordPress site with thousands of posts, broken links accumulate whether you notice them or not. External sites delete pages. Internal pages get renamed or moved. Every one is a potential SEO problem.

A scan shows you the broken links in your 200 most recent published posts and pages.


How a scan runs

Open Tools in the Rank Forge menu, select the Broken Links tab and click Scan Now. Rank Forge takes the 200 most recent published posts, pages and other public content, splits them into batches of 10 and hands the batches to the Forge Queue, which WP Cron starts in the background. The page shows that a scan is running until the last batch is done. Reload the page to see the result.

There is no schedule. Nothing scans on its own, so run a scan when you want a fresh result, for example after a migration or a change of permalinks.


What gets checked

  • Every link written as <a href> in the body of a post or page. Links that start with #, mailto: or tel: are skipped.
  • Internal links (relative or on your own domain) and external links. Within a batch, each address gets one HTTP HEAD request, however many posts link to it.
  • Only the post body is read. Menus, widgets, custom fields and comments are not scanned, and an image (<img src>) is not checked on its own.
  • Addresses on a private or reserved network are skipped.

What counts as broken

  • An HTTP status of 400 or higher, such as 404 Not Found, 410 Gone or 500 Server Error. The table shows the status code.
  • No answer at all, such as a timeout, a DNS failure or a refused connection. The table shows “Error”. Each request waits 2 seconds, so a slow site can show up as an error.

A link that answers with a redirect is not reported, because the scanner does not follow redirects.


The results table

The table lists each broken address next to the post it was found in:

  • The post title, linked to its editor
  • The broken URL
  • The status code, or “Error”
  • An Edit button that opens the post

The table has no filters, no sorting and no bulk actions, and Rank Forge does not change your content: you fix the link in the editor. For an internal address that has moved, add a redirect in the Redirect Manager (Rank Forge > Tools, tab Redirects).


How long the result is kept

The result is cached for one day. After that the table is empty until you scan again, and the screen shows only the time of the last scan.


REST route in the Pro add-on

The Pro add-on lets REST clients check the links of a single post: GET /wp-json/rankforge/v1/links/broken/{post_id} returns the status of every link in that post. It uses the same HEAD request and no AI credits.


Ready to find and fix broken links?

See pricing →

The Broken Links Checker is part of the free Rank Forge plugin.

Forge AI Assistant Online

Hi! I'm the Rank Forge AI assistant. Ask me anything about the plugin — setup, features, troubleshooting, or development.

Just now
Powered by Forge AI · Browse docs