Documentation

Everything you need to scan, check and fix the links on your site.

Getting started

  1. Install and activate HrefHub from Plugins → Add New.
  2. Open HrefHub in the admin menu.
  3. Click Scan site. It reads your posts first, then checks each link’s status. A progress bar shows where it is, and Stop pauses it at any time.

After the first scan, saving a post updates its links straight away. A later scan only re-checks links that are new or haven’t been checked for 7 days. Check links re-checks everything now.

What the statuses mean

StatusMeaningWhat to do
OKThe link goes straight to a working page.Nothing.
RedirectIt works, but hops through one or more redirects first.Optional: flatten it to the final address.
BrokenPage not found, host gone or similar — confirmed on two checks.Change the URL or unlink it.
Needs reviewThe server refused the check (403, 429, 503) — often a bot filter like Cloudflare.Open it in a browser. It usually works fine.

A link that fails once is shown as “will be confirmed on the next check”. It is only called broken after a second failure, so a brief outage never sends you chasing a link that’s fine.

Changing a URL everywhere

  1. Find the URL in the table — search, or filter by status, host or post type.
  2. Click Change URL and type the new address.
  3. Check the preview: it lists every post that will change.
  4. Confirm. A message says how many posts were changed.

Each run changes up to 50 posts. If a URL is used in more, run it again — the message tells you how many still use it. Unlink (in the menu beside each row) removes the link but keeps its text.

Flattening redirects

Filter to Redirects, select the rows (or all of them), and choose Replace redirects with their final destination from the bulk actions. Each link is rewritten to point straight at where it already ends up.

Undo

Before any post is changed, HrefHub saves a snapshot of it. Undo restores the last change in one click. If you’ve edited one of those posts since, it’s skipped so your newer work isn’t lost. WordPress post revisions stay switched on as a second way back.

Settings and export

HrefHub → Settings lists your public post types with a count of each. Untick any you don’t want scanned; their links leave the inventory immediately. Export CSV downloads every link in the current view.

Uninstalling

Deleting the plugin removes its three database tables and all its options. Your posts keep whatever links they have at that moment.

Stuck? Ask in the support forum.