LinkHound Help

LinkHound help

Everything you need to get LinkHound running, read its results and fix what it finds. Can't find your answer? Email [email protected] and I'll help.

Getting started

  1. In WordPress, go to Plugins → Add New, search for LinkHound, then install and activate LinkHound - Broken Link Checker.
  2. Open LinkHound in the admin menu.
  3. Click Scan now. LinkHound reads your posts and pages and starts checking links while you watch. You can leave the page at any time; the rest happens in the background.

After that you don't need to do anything. LinkHound picks up new and edited posts when you save them, and rechecks every link every few days.

Links are only marked Broken after they fail three times over at least twelve hours, so a fresh scan mostly shows Being confirmed at first. That's normal. Give it a day.

What the statuses mean

BrokenFailed three checks over at least twelve hours. This is the list to work through.
Being confirmedFailed once or twice. LinkHound checks again about every six hours. If a check works, it goes back to Working and you never hear about it.
RedirectsWorks, but sends visitors on to another address. Not urgent, but updating the link saves a hop.
Couldn't verifyThe site refuses automated checks (LinkedIn, Amazon, sites behind bot protection), or your server couldn't reach its own page. Open the link yourself to be sure.
WorkingChecked and fine.
Not checked yetFound, but waiting for its first check.

The Found in column shows which posts use the link and the link text, so you can see the context before you change anything.

Fixing links

Hover over a link in the list to see what you can do with it:

  • Edit URL changes the address everywhere the link is used.
  • Unlink removes the link but keeps its text. For a broken image, the image is removed.
  • Update to final URL (on redirects) swaps the link for the address it ends up at.
  • Recheck checks the link again right away.
  • Not broken / ignore hides a link you know is fine. You'll find it under Ignored, where Stop ignoring brings it back.

Every fix is saved as a normal WordPress revision, so you can undo it from the post's revision history.

Settings

Under LinkHound → Settings:

  • Content to scan: which post types to read. Posts and pages are on by default; add products, portfolios and so on here.
  • What to check: turn off Links to other websites to only check your own pages, or Images to skip images.
  • Never check these domains: one domain per line, subdomains included. Handy for sites you know block checks.
  • Email: a weekly email, only sent when there are broken links, to the address you choose.

Installing LinkHound Pro PRO

Pro is an add-on. Keep the free plugin installed; Pro works next to it.

  1. After buying, you get an email with a download link and your license key.
  2. Download the zip, then go to Plugins → Add New → Upload Plugin, upload it and activate LinkHound Pro.
  3. Go to LinkHound → LinkHound Pro, paste your license key and click Activate license.

Pro adds two tabs on the LinkHound page: Alerts & Schedule and 404s & Redirects. Updates arrive in Dashboard → Updates like any other plugin.

Alerts PRO

On the Alerts & Schedule tab, switch on one or more channels:

  • Email: sent to the address you enter.
  • Slack: paste an "Incoming Webhook" URL from your Slack workspace.
  • Webhook: LinkHound sends a JSON POST to any https address. Works with Zapier, Make, n8n or your own app.

You get one message as soon as links are confirmed broken. If several break in the same scan, they arrive together. Tick Fixed links to also hear when a broken link starts working again. Use Send test alert to check your setup.

Scheduled scans PRO

LinkHound already rechecks links every few days. A full scan re-reads all your content and rechecks every link in one go. Choose Every night or Once a week under Run a full scan; it starts at 03:00 site time. Start a full scan now runs one right away.

404s and redirects PRO

The 404 log lists the addresses visitors tried to open that don't exist, with a visit count and where they came from. Linked from your site means one of your own pages links there: fix those first.

  1. Click Redirect next to an address. LinkHound fills in the closest matching page it can find; check it.
  2. Choose the type: 301 (moved for good, best for SEO), 302 (moved for now) or 410 (gone on purpose, no redirect).
  3. Save. Links to that address on your site are rechecked shortly after.

On the Links tab, broken links to your own pages also get a Fix with redirect action. Redirects only apply when WordPress would otherwise show a "not found" page, so they can never take over a page that exists.

The log stores the address, a counter, dates and the referring page without its query string. No IP addresses or visitor details. Entries older than 90 days are removed automatically, and you can Pause 404 logging at any time; redirects keep working.

Your license PRO

  • Moving to another site: on the old site, go to LinkHound → LinkHound Pro → License & account and deactivate the license. Then activate it on the new site.
  • When it expires: Pro keeps working with all its features. You just stop getting updates and support until you renew.
  • Refunds: within 14 days of buying, if it doesn't work out. Email me.
  • Local development sites: activating on localhost doesn't use up one of your sites.

Troubleshooting

The scan is very slow or doesn't move

Background checks run on WordPress's built-in scheduler (WP-Cron), which only runs when someone visits the site. On quiet sites, keep the LinkHound page open with Scan now, or ask your host to call WP-Cron every five minutes. If your wp-config.php has DISABLE_WP_CRON, a real cron job is required, for example:

*/5 * * * * curl -s https://example.com/wp-cron.php?doing_wp_cron > /dev/null

LinkHound also pauses when your server is under heavy load, and carries on later.

Links to my own site say "Couldn't verify"

Most links to your own posts and uploads are checked straight from the database and disk. For other addresses, LinkHound asks your own server for the page, and some hosts block that (it's called a loopback request). Open the link yourself to check it. If it really is gone, a redirect fixes it.

I'm not getting the weekly email or alerts

Check your spam folder first. Many hosts send WordPress email poorly; an SMTP plugin that sends through a real mail service usually fixes it. With Pro, Send test alert shows straight away whether email arrives.

My 404s don't show up in the log

A page cache (a caching plugin or your host's cache) may serve "not found" pages without running WordPress. Exclude 404 pages from the cache and they'll appear.

A link works in my browser but LinkHound says it's broken

Some sites answer automated requests differently from browsers. Click Recheck first. If it still fails and you're sure it's fine, use Not broken / ignore, or add the domain under Never check these domains.

What happens if I delete LinkHound?

Deleting the free plugin removes its tables and settings. Your posts are untouched. Deleting Pro also removes its redirects and 404 log, so the old addresses show "not found" again. Deactivating keeps everything.

Still stuck? Email [email protected] with what you see (a screenshot helps). It comes straight to me, Oliver, and I'll answer myself.