How can I create url rewrites in asp net core at runtime


ASP.NET is a popular programming language used for building web applications. One requirement in web development is the ability to create URL rewrites, which allow you to map one URL to another. In this article, we will explore how to create URL rewrites in ASP.NET Core at runtime.

What are URL Rewrites?

URL Rewrites are a way to modify the URL of a web before it reaches the server. This can be useful for various reasons, such as improving search optimization (SEO), creating user-friendly URLs, or redirecting old URLs to new ones.

Using the ASP.NET Core Rewrite Middleware

In ASP.NET Core, URL rewrites can be achieved using the Rewrite Middleware. This middleware allows you to define rules for rewriting URLs based on various conditions.

To use the Rewrite Middleware, you need to add it to your application's request pipeline. This can be done in the Configure method of your Startup class:

public void Configure(IApplicationBuilder app)
    app.UseRewriter(new RewriteOptions()
        .AddRewrite("old-url", "new-url", skipRemainingRules: true)
        .AddRewrite("another-old-url", "another-new-url", skipRemainingRules: true)
        // Add more rewrite rules here

    // Other middleware configurations

In the above , we are adding two rewrite rules using the AddRewrite method. The first parameter is the pattern to match in the incoming URL, and the second parameter is the replacement URL. The skipRemainingRules parameter is set to true to ensure that only the first matching rule is applied.

Dynamic URL Rewrites at Runtime

the above approach works well for static URL rewrites, there may be scenarios where you need to create URL rewrites dynamically at runtime. For example, you may want to allow users to define their own custom URL mappings.

To achieve dynamic URL rewrites, you can use a combination of the Rewrite Middleware and a custom configuration source. Here's an example:

public void Configure(IApplicationBuilder app, IConfiguration configuration)
    var rewriteOptions = new RewriteOptions();
    // Get the custom URL mappings from configuration
    var urlMappings = configuration.("UrlMappings").Get>();
    // Add rewrite rules dynamically based on the custom URL mappings
     (var  in urlMappings)
        rewriteOptions.AddRewrite(mapping.Key, mapping., skipRemainingRules: true);

    // Other middleware configurations

In the above example, we are retrieving the custom URL mappings from the application's configuration using the GetSection method. The configuration be structured as a dictionary, where the key represents the pattern to match and the value represents the replacement URL.

We then iterate over the custom URL mappings and add them as rewrite rules using the AddRewrite method. This allows us to dynamically create URL rewrites based on the user-defined mappings.


URL rewrites are an essential part of web development, and ASP.NET Core provides a flexible and powerful way to create them. By using the Rewrite Middleware and a custom configuration source, you can easily create both static and dynamic URL rewrites in your ASP.NET Core applications.

Rate this post

Leave a Reply

Your email address will not be published. Required fields are marked *

Table of Contents