BT.RedirectManager 1.7.0

BT Redirect Manager

A URL redirect manager plugin for Umbraco CMS 13, 17, and 18. Manage 301, 302, 404, and 410 redirects directly from the Umbraco backoffice with a redesigned modern dashboard, CSV import/export, regex support, domain scoping, windowed (7d/30d) hit-count analytics, A/B testing, scheduled backups, and a built-in test tool.

Screenshots

Features

• Multiple status codes: 301 (Permanent), 302 (Temporary), 404 (Not Found), and 410 (Gone) — each with a distinct soft-color badge in the dashboard.
• Redesigned backoffice dashboard: Clean, modern UI built with Lit (Umbraco 17/18) and AngularJS (Umbraco 13). Compact status legend, search bar, filters, bulk selection, and tab-based navigation all in one view.
• Domain-scoped redirects: Scope a redirect to a specific hostname for multi-site installs. The same Old URL can point to a different New URL per domain, with domain-specific rules taking precedence over global ones. Leave the Domain field blank to apply a redirect to all domains.
• Regex and exact match: Support for both exact path redirects and regex rules with $1 capture groups. Regex rules are highlighted with a purple pill in the dashboard.
• Hit-count analytics: Every redirect tracks how many times it has fired and when it was last hit, plus rolling 7-day and 30-day totals, visible directly in the redirect list — useful for spotting stale redirects to retire or rules that aren't firing when they should.
• 404 log with one-click redirect creation: Genuine 404s are logged automatically with hit count, first seen, and last seen dates. Turn any frequent 404 into a redirect in a single click.
• CSV import/export: Migrate or bulk-edit redirects via CSV files.
• Scheduled CSV backup: Opt-in periodic backup of all redirects to a local folder and/or by email (RedirectManager:Backup config), independent of manual export.
• A/B testing: Split traffic on a 301/302 exact-match rule between two target URLs by percentage, with per-visitor sticky assignment (cookie) and separate hit counts per variant.
• Dashboard overview: Totals, active/inactive counts, top 10 most-used redirects, and active redirects with zero hits in the last 30 days — exportable as CSV, with an optional periodic summary email.
• Trailing-slash matching: An exact-match rule fires regardless of a trailing-slash mismatch between the request and the stored Old URL.
• Built-in test tool: Test a path before saving to confirm which redirect rule will match.
• Update notifications: The dashboard checks NuGet.org once every 24 hours and shows a persistent banner whenever a newer version is available — always on, no configuration, no site data sent.
• Backoffice-secured API: All redirect-management endpoints require an authenticated Umbraco backoffice session with a valid bearer token.
• Automatic database migration: Tables are created and updated automatically on first run — no manual SQL required.
• Auto-copy App_Plugins: App_Plugins assets are copied to the output directory on build via the included MSBuild targets file.

Installation

dotnet add package BT.RedirectManager

Or via the NuGet Package Manager:

Install-Package BT.RedirectManager

After installation, restart your Umbraco application and open the Redirect Manager dashboard from the Settings section in the backoffice.

Usage

1. Navigate to Settings → Redirect Manager in the Umbraco backoffice.
2. Click + Add redirect to create a new redirect rule.
3. Fill in the Old URL, New URL, status code, and optionally a domain and notes.
4. Toggle Active to enable or disable the rule without deleting it.
5. Enable Regex match to use regular expression patterns and $1 capture groups in the New URL.
6. Use the Test button on any row to verify a redirect resolves as expected.
7. Switch to the 404 Log tab to review unmatched requests and convert them to redirects with one click.
8. Use Export CSV / Import CSV for bulk operations.
9. For a 301/302 exact-match rule, enable A/B test to split traffic between New URL and a second Variant B URL by percentage — visitors are assigned once and stay on their variant via a cookie.
10. Switch to the Overview tab for totals, the top 10 most-used redirects, and active redirects with zero hits in the last 30 days — exportable as CSV.

Status Codes

Database

The plugin creates three tables automatically:

RedirectManagerEntries

RedirectManagerHitDaily

One row per redirect per UTC day, used to compute the 7-day/30-day rolling totals shown in the dashboard. Rows older than 35 days are pruned automatically.

RedirectManagerMissedRequests

Logs genuine 404 responses (path, hit count, first seen, last seen). Entries older than 90 days are cleaned up automatically.

Configuration

The plugin works out of the box with no configuration required. Scheduled CSV backup and the periodic overview email are opt-in and configured via appsettings.json, under RedirectManager:Backup:

{
  "RedirectManager": {
    "Backup": {
      "Enabled": false,
      "FolderPath": "App_Data/RedirectManagerBackups",
      "IntervalHours": 24,
      "RetentionCount": 30,
      "EmailTo": "",
      "SummaryEmailEnabled": false,
      "SummaryEmailTo": "",
      "SummaryIntervalHours": 168
    }
  }
}

Email delivery (both the raw backup and the overview report) uses Umbraco's own SMTP configuration (Umbraco:CMS:Global:Smtp, standard for any Umbraco site) — a From address must be set there, or email delivery is skipped with a warning in the log.

Telemetry (opt-in, off by default)

The plugin can optionally send a small "still installed, here's the version" ping to the maintainer, so they can see which sites are actively using it. This is entirely opt-in — nothing is ever sent unless you explicitly turn it on.

The first time you open the dashboard, you'll be asked once: "Help improve Redirect Manager?" with Yes / No thanks — your answer is saved and you won't be asked again. You can change your mind anytime from the "Send anonymous usage data" toggle on the Overview tab. There is no appsettings.json configuration for this; the prompt/toggle is the only control.

What's sent, when enabled: a random ID generated once and stored locally in App_Data/RedirectManagerTelemetry/site-id.txt (not derived from any identifying information), this site's domain (read from the current request automatically — never typed in), the plugin version, and the Umbraco version — nothing else. No redirect rules, no traffic data, no IP addresses are collected by this plugin. Sent once when you accept the prompt (or flip the toggle on), then at most once every 24 hours — either from the dashboard being opened or from a periodic background check, whichever happens first in a given 24-hour window.

License

MIT

Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.