recranet/craft-redirects

Simple redirect management for Craft CMS

Maintainers

Package info

github.com/recranet/craft-redirects

Type:craft-plugin

pkg:composer/recranet/craft-redirects

Statistics

Installs: 17

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

1.1.1 2026-03-12 09:27 UTC

Requires

MIT dd8af3d48ebad8636ec6c3f78852c9aa33d5b7ef

This package is auto-updated.

Last update: 2026-03-12 09:32:16 UTC

README

A redirect management plugin for Craft CMS 5. Manage URL redirects, track 404s, and keep your site's URL structure clean — all from the control panel.

Features

  • Exact & regex redirects with support for captured groups ($1, $2, etc.)
  • 301, 302, 307, 308 status codes
  • 404 logging — automatically tracks not-found URLs with hit counts
  • Hit tracking — see how often each redirect is used and when it was last hit
  • Chain detection — warns when a redirect points to another redirect's source URL
  • Search & sort — filter and sort redirects by any column
  • Bulk actions — enable, disable, or delete multiple redirects at once
  • CSV import/export — import redirects from CSV or export your full list
  • Labels & notes — organize redirects with optional metadata

Requirements

  • Craft CMS 5.0 or later
  • PHP 8.2 or later

Installation

composer require custom/craft-redirects
php craft plugin/install redirects

Usage

After installation, a Redirects item appears in the control panel sidebar with three sections:

Redirects

Create and manage redirects. Each redirect has:

Field Description
From URL The path to redirect from (must start with /)
To URL The destination URL
Type HTTP status code (301, 302, 307, 308)
Match Type exact or regex
Label Optional label for organization
Notes Optional notes

Exact match redirects are case-insensitive and normalize trailing slashes — /old-page and /old-page/ are treated the same.

Regex match redirects use PCRE patterns. Captured groups can be referenced in the destination URL:

From URL To URL Example
/blog/(\d{4})/(.*) /articles/$1/$2 /blog/2024/my-post -> /articles/2024/my-post

Import

Import redirects from a CSV file. The import flow provides column mapping and a preview before importing. An example CSV is available for download.

404 Log

View all URLs that returned a 404, sorted by hit count. From here you can create a redirect directly from any logged URL.

Settings

Navigate to Settings > Redirects to configure:

  • 404 Logging — Enable or disable automatic 404 request logging (enabled by default)