Getting Started with Tidy Broken Link Scan
This guide walks you through installing Tidy Broken Link Scan, running your first site-wide scan, and understanding the results dashboard.
1. System Requirements
Before installing Tidy Broken Link Scan, make sure your WordPress environment meets the following requirements:
- WordPress 6.0 or higher — The plugin uses modern WordPress APIs and requires at least version 6.0.
- PHP 8.2 or higher — The plugin uses modern PHP features including typed properties, enums, and readonly classes.
- WP-Cron enabled — Tidy Broken Link Scan relies on WP-Cron for scheduled background scans. If you have disabled WP-Cron, you can use a real cron job instead.
The plugin is compatible with all well-coded WordPress themes and works alongside caching plugins such as WP Super Cache, W3 Total Cache, and LiteSpeed Cache without any conflicts.
2. Installation
Option A: Install from the WordPress Plugin Directory
- In your WordPress admin, go to Plugins → Add New.
- Search for "Tidy Broken Link Scan" in the search bar.
- Click Install Now next to the Tidy Broken Link Scan plugin.
- Once installed, click Activate.
Option B: Manual Upload
- Download the Tidy Broken Link Scan plugin ZIP file from your account dashboard or the WordPress plugin directory.
- In your WordPress admin, go to Plugins → Add New → Upload Plugin.
- Choose the ZIP file and click Install Now.
- Once installed, click Activate.
After activation, you will see a new "Liens cassés" menu item in your WordPress admin sidebar. This is your main dashboard for managing broken links.
3. Running Your First Scan
Navigate to Liens cassés in your WordPress admin. You will see an empty dashboard with a prominent "Scanner tout le site" button.
- Click "Scanner tout le site" to start a full scan of all your posts and pages.
- Wait for the scan to complete. The plugin processes content in the background,
checking every link (
href) and image (src,srcset) in your content. - Review the results. Broken links are displayed with their HTTP status code, the source post, and a direct link to edit the post where the broken link appears.
After the initial scan, the plugin automatically runs a daily scan at 03:00 (server time) via WP-Cron to keep your link health up to date.
4. Understanding the Dashboard
The Tidy Broken Link Scan dashboard provides a clear overview of all detected issues:
- Status code — The HTTP response code (404, 403, 500, timeout, etc.) for each broken link.
- URL — The broken link or image URL that was detected.
- Source post — The post or page containing the broken link, with a direct edit link.
- Type — Whether the broken resource is a link or an image.
- Filters — Filter results by status code, link type, or source post to quickly find what you need.
Click the edit link next to any broken link to jump directly to the WordPress editor for the source post, where you can update or remove the broken URL.
5. Upgrading to Pro
The free version of Tidy Broken Link Scan includes full site scanning, daily automatic checks, and the admin dashboard. Upgrading to Pro unlocks:
- Priority scanning — Faster scan processing for large sites with thousands of posts.
- Link replacement — Find-and-replace broken URLs across your entire site without editing individual posts.
- Ignore rules — Create rules to ignore specific URLs or domains that trigger false positives.
- Slack notifications — Get notified in Slack when new broken links are detected.
- Health score dashboard — A visual overview of your site's overall link health with trends over time.
To upgrade, visit the pricing page, choose your plan, and complete the checkout. You will receive a license key by email. Enter the license key in the plugin settings to activate Pro features.