Broken Link Checker

Scan your site for broken links that frustrate visitors and hurt SEO. Find internal links pointing to deleted pages and external links to sites that no longer exist.

Use Cases

  • Find broken internal links after deleting or moving content
  • Discover external links that have gone dead over time
  • Audit your site’s link health before a redesign
  • Improve user experience by eliminating dead ends

How It Works

  1. Open the module settings in Switchboard
  2. Click “Start Scan” to begin checking all links
  3. The scanner crawls through published posts and pages
  4. Each link is tested for response status (200, 404, timeout, etc.)
  5. Results show which links are broken and where they appear

What Gets Scanned

The module scans links in:

  • Published posts
  • Published pages
  • Both Classic Editor and Gutenberg block content
TypeExampleChecked For
Internal/about-us/, /blog/post-title404 errors, unpublished status
Externalhttps://example.com404, timeout, DNS failure

Note: Anchor-only links (#section-name), mailto:, tel:, and javascript: links are skipped.

Scan Results

After a scan completes, you’ll see:

  • Posts Scanned: Number of posts and pages checked
  • Unique URLs Checked: Total distinct URLs tested
  • Broken Links: Links returning errors

Result Details

For each broken link, the report shows:

ColumnDescription
Post/PageLink to edit the source content
Broken URLThe URL that failed
TypeInternal or External
ErrorThe error message or status code

Understanding Status Codes

StatusMeaningAction
404Page not foundUpdate or remove link
403Access forbiddenMay be blocked; verify manually
500Server errorTemporary issue; recheck later
TimeoutNo responseSite slow or down; recheck later
Domain not foundDNS errorRemove link

Option 1: Edit the Source

  1. Click the post/page link in results
  2. Find the broken link in the editor
  3. Update to the correct URL or remove it
  4. Update the post

Option 2: Create a Redirect

If content has moved:

  1. Note the broken URL
  2. Use Redirects Manager to create a redirect
  3. Point the old URL to the new location

Performance Considerations

Link checking makes HTTP requests to verify each URL. For large sites:

  • Scan timeout: The scanner has a built-in timeout (~45 seconds) to prevent server overload
  • Resume scanning: If timeout occurs, run the scan again—URLs are cached during the session
  • External link limits: The scanner uses reasonable timeouts to avoid being blocked

Scanning a site with thousands of links may take several attempts due to timeout limits. The scan will indicate if it was interrupted.

Common False Positives

Some links may report as broken but actually work:

  • Rate-limited sites: Sites that block automated checking
  • Login-required pages: URLs that require authentication
  • Geo-restricted content: Sites that block certain regions

Verify these links manually before removing them.

FAQ

How long does a scan take?Depends on your site size. The scanner has a ~45 second timeout per scan. Sites with many links may require multiple scans.
Will scanning affect my site’s performance?Minimally. Internal link checks use fast database queries when possible. External checks are throttled with timeouts to avoid impacting your server.
Does it check links in comments?No. The scanner focuses on post and page content only.
Why does a working link show as broken?Some sites block automated requests or require specific headers. Try visiting the link manually to verify.
Does it scan custom post types?Currently, the scanner checks posts and pages. Custom post types are not included.
PRO

Get access to all 147 modules with a single license

Upgrade to Pro