×
darylgio agoncillo

IIS Rewrite Maps and Redirecting On Url Paths

Written by Khalid Abuhakmeh |Kevin Hougasian |Bill Boga
2
This post is days old.

URLs are the bridges that connect our little island of a website to the bigger continent known as the Internet. Preserving URL integrity is the utmost importance for providing an excellent experience for new and existing users alike. Sadly, from a development and management standpoint, keeping old paths working for a new site can be a real pain in the butt. In this post, we’ll show you how to use redirect maps to create a lookup dictionary for old URL paths. This post will also help you preserve query string parameters.

Configuration

We started by exploring the Microsoft documentation site around rewrite maps. For rewrite maps, you will need to make sure you are running your site on Internet Information Services with the rewrite module.

What you will need in your web.config is a rewriteMaps section under system.webserver/rewrite with the rewrite maps section containing the old URL paths and their new destinations.

<rewrite>
    <rewriteMaps>
        <rewriteMap name="StaticRewrites" defaultValue="">
            <add key="/one" value="/new-one" />
            <add key="/two" value="/new-two" />
        </rewriteMap>
    </rewriteMaps>
</rewrite>

This rewrite map then needs a subsequent rule to match the URL path.

<rule name="Redirect rule for StaticRewrites" stopProcessing="true">
    <match url=".*" />
    <conditions>
        <add input="{StaticRewrites:{URL}}" pattern="(.+)" />
    </conditions>
    <action type="Redirect" url="{C:1}" redirectType="Permanent"/>
</rule>

Note that the use of {URL} in our rule. The rule makes sure we look into the rewrite map using only the URL’s path. If you were to use anything else, you likely will not get a match. If you need to match on anything else, please look into the IIS documentation to understand your options.

Try it out and hopefully we’ve saved you some keystrokes :)

Khalid Abuhakmeh
Khalid Abuhakmeh
Director of Software Development
Kevin Hougasian
Kevin Hougasian
Lead Frontend Developer
Bill Boga
Bill Boga
Senior Software Developer
IIS
Azure
SEO
Suggested reading

Hugo Error Pages With IIS In Windows Azure

Azure
Static site hosting is straightforward, and from our experience, less likely ...
Read now

Setting Azure Web App Slot Auto Swap Using ARM Templates and Terraform

Azure
We’re in the process of scaffolding out our Microsoft Azure environments usin...
Read now

Export CSV Table of All Azure Web Apps Configuration in Subscription

Azure
At Ritter Insurance Marketing we utilize Azure Web Apps for hosting many of o...
Read now

Secure Global Stuntman Users With Windows Azure Blob Storage

Azure
Stuntman is an open source library we developed at RIMdev to make testing use...
Read now

Leveraging Metadata with Google Tag Manager

SEO
Our APIs expose data to Ritter’s quote engines based on product, marketplace,...
Read now

Fixing Facebook Open Graph 404 Post Previews

SEO
TL;DR use the Facebook Open Graph Debugger to refresh the scraping cache. In...
Read now

Comments

Stay fresh! The brighter green, the fresher the article!