README

A link scanning utility for Craft CMS. It can scan issues with every link all in one go.

Why This Plugin Exists

Real sites get messy over time:

Editors add content for years
URLs change after redesigns
External sites disappear
Redirect chains accumulate

Manually checking every link is impossible. However, Bulk Link Checker does this for you.

Features

Full multi-site scanning
Redirect‑chain tracking
Internal & external link checking
Advanced filtering
Export to CSV
Optional draft/disabled content scanning
See HTTP status codes & messages
Optional asset scanning (images/files)
Craft queue‑based background scanning
Utility UI with grouped results
Console command for CI/CD

Redirect Handling

This plugin automatically:

Captures all redirect hops
Displays the full redirect chain
Tracks the final resolved URL
Distinguishes direct 200 vs 200 via redirect

Example:

301 /old-url    → /new-url
301 /new-url    → /newer-url
200 /newer-url

Installation

Via Composer

composer require acelabs/bulk-link-checker

Then enable the plugin in:

Settings → Plugins

Control Panel Usage

Select sites to scan
Choose internal / external / both link types
Apply ignore patterns
Scan pages and field content
View grouped results
Inspect redirect chains
Fix issues and rescan
Export to CSV

Command‑Line Usage (Craft Console)

Run a scan:

php craft bulk-link-checker/scan/run

Perfect for automated workflows, CI pipelines, and local dev tools.

CLI Options

Sites

--sites=1,2
--sites=default,en

Accepts IDs or handles.

Entry Scope

--entryScope=all        (default)
--entryScope=section
--entryScope=entryType

If using section/entryType:

--sections=3,7
--entryTypes=12,13

Link Types

--linkMode=both         (default)
--linkMode=internal
--linkMode=external

Additional Options

--includeDisabled=1
--checkContentLinks=0
--checkAssets=1

Ignore Patterns

--ignorePatterns="google.com
facebook.com"

Output Format

--format=text
--format=json

JSON is ideal for CI.

Example CI Run

php craft bulk-link-checker/scan/run   --sites=default   --linkMode=external   --format=json

Exit Codes:

0 → All good
1 → Broken links detected

Performance

It is possible to configure the amount of links checked at once with a config file to a maximum of 50 link requests concurrently, massively speeding up the process of checking each link.

Paste the following return statement in config/bulk-link-checker.php

<?php
return [
    // How many URLs to hit in parallel (per entry / per pool)
    'concurrency' => 10,
];

Be sure to match this with what your server can handle as to avoid performance issues with loading pages as higher values can stress the CPU further. The more CPU threads, the better.

Also be mindful of requesting many links from a single external domain as that may flag it as spam if you request too many. So use the ignore URL patterns feature to your advantage.

acelabs / bulk-link-checker

Maintainers

Details