Skybrud.Umbraco.Redirects

Looking for the Umbraco 7 version of the package?

Skybrud.Umbraco.Redirects is a redirects manager for Umbraco 8. The package features a dashboard and property editor that let's users manage inbound redirects from within the Umbraco backoffice.

URLs can be added to redirect to either a content item, media item or a custom URL.

Installation

Install via NuGet

This is the recommend approach, as you install the NuGet Package in your Visual Studio project, and NuGet takes care of the rest.

Umbraco 8
Latest release for Umbraco 8 is v2.0.0:

Install-Package Skybrud.Umbraco.Redirects -Version 2.0.0

Umbraco 7
Latest release for Umbraco 7 is v0.3.5:

Install-Package Skybrud.Umbraco.Redirects -Version 0.3.5

Manual install

You can also download a ZIP file of the latest release directly from GitHub, unzip, and move the contents to the root directory of your web application.

1. Download ZIP file
   Download the ZIP file directly from here on GitHub. The ZIP contains all necessary files to run the package.

2. Unzip
   Unzip and move the contents to the root directory of your web application.

3. Install HTTP module
   The package features a HTTP module. When downloading the ZIP file, you must install this manually. In your root Web.config file, search for the <system.webServer> element. Then add the following to the <modules> child element:

   <remove name="RedirectsModule" />
   <add name="RedirectsModule" type="Skybrud.Umbraco.Redirects.Routing.RedirectsModule, Skybrud.Umbraco.Redirects" />

   The order shouldn't matter that much, but we typically add it right after:

   <remove name="UmbracoModule" />
   <add name="UmbracoModule" type="Umbraco.Web.UmbracoModule,umbraco" />

Features

• Global dashboard for listing all redirects. Supports filtering and searching.

• Property editor that can be added to either a content item or media item to show inbound redirects

• Package only handles custom redirecs - eg. added manually by an editor. The will let Umbraco 7.5+ handle redirects for renamed pages

• Includes a RedirectsRepository for managing the redirects from your own code

Screenshots

Besides the dashboard shown in the top of this page, the package also features property editor that let's users add new inbound redirect directly from the content or media item being editied.

For instance the screenshot below illustrates the property editor added to a content type:

Or the same property editor added to a media type - eg. here added to the Image media type:

Under the hood

The package comes with a HTTP module that will kick in when Umbraco or IIS returns a response with a 404 status code. If this is the case, the module will look up the requested URL, and then redirect the user if a matching redirect is found in the database.