![](https://imaginet.com/wp/wp-content/uploads/2023/02/ImaginetBlogBackground.png)
Step-by-Step Tutorial: IIS
Redirect/Rewrites for SharePoint
NOTE: THIS IS NOT SUPPORTED BY MICROSOFT; PROCEED WITH CAUTION AND AT YOUR OWN RISK.
Perform the following steps on the Web Front End servers only.
When working with websites, it is imperative for the users, customers, and possibly potential customers to be able to locate information when accessing them. Change is inevitable within life just as much as it is in the companies and organizations that employ us. Companies change their structure, names, products, and so forth, which eventually reach the website. This tutorial will ensure that any of those do not impact SEO rankings and 404 Page Not Found errors.
Initial Install/Setup
Download and install the Rewrite Plugin for IIS Redirect
In order to obtain the extension for IIS go to http://www.iis.net/downloads/microsoft/url-rewrite and download the extension.
Once the extension is downloaded, you can install it on the server. After the extension is installed, close and reopen IIS Manager to begin utilizing the extension.
Create a Mapping
1. From within IIS Manager, click on the site you wish to add the redirect/rewrites too.
![IIS Redirect tutorial](http://www.imaginet.com/wp/wp-content/uploads/2017/04/create-a-mapping-1.png)
2. Under the IIS section in the middle pane select URL Rewrite.
![IIS Redirect tutorial](http://www.imaginet.com/wp/wp-content/uploads/2017/04/create-a-mapping-2.png)
3. On the right in the Actions panel, select the View Rewrite Maps under the Manage Providers.
![IIS Redirect tutorial](http://www.imaginet.com/wp/wp-content/uploads/2017/04/create-a-mapping-3.png)
4. From the Actions pane on the right, select the Add Rewrite Map
![IIS Redirect tutorial](http://www.imaginet.com/wp/wp-content/uploads/2017/04/create-a-mapping-4.png)
5. Enter a name for the new mapping.
![IIS Redirect tutorial](http://www.imaginet.com/wp/wp-content/uploads/2017/04/create-a-mapping-5.png)
6. After creating the map, double-click on the mapping.
![IIS Redirect tutorial](http://www.imaginet.com/wp/wp-content/uploads/2017/04/rule-referencing-5.png)
7. From the Actions pane on the right, click Add Mapping Entry
![IIS Redirect tutorial](http://www.imaginet.com/wp/wp-content/uploads/2017/04/create-a-mapping-7.png)
8. In the pop-up window, enter the old URL in the Original Value. Then enter the new URL in the New Value section and click OK.
![IIS Redirect tutorial](http://www.imaginet.com/wp/wp-content/uploads/2017/04/create-a-mapping-8.png)
9. You will then see the new entry in the pane.
![IIS Redirect tutorial](http://www.imaginet.com/wp/wp-content/uploads/2017/04/create-a-mapping-9.png)
10. Once you have added your entry then, from the Actions pane on the right, select Back to Rules.
![IIS Redirect tutorial](http://www.imaginet.com/wp/wp-content/uploads/2017/04/create-a-mapping-10.png)
Create a Rule Referencing the Mapping for IIS redirect
Now that you have created the mapping, you must create the rule to reference the mapping.
1. From the Actions pane on the right click the Add Rule.
![IIS Redirect tutorial](http://www.imaginet.com/wp/wp-content/uploads/2017/04/rule-referencing-1.png)
2. When selecting the type of rule from the pop-up pane, select the Rule with Rewrite Maps.
![IIS Redirect tutorial](http://www.imaginet.com/wp/wp-content/uploads/2017/04/rule-referencing-2.png)
3. In the pop-up pane for Select the Rule Action, you can select either Redirect or
![imginet sharepoint tutorial](http://www.imaginet.com/wp/wp-content/uploads/2017/04/rule-referencing-3.png)
4. From the same pop-up pane select your mapping you created previously.
![Imaginet blog](http://www.imaginet.com/wp/wp-content/uploads/2017/04/rule-referencing-4.png)
5. After you click OK you will see your new rule referencing your mapping.
![Imaginet Blog](http://www.imaginet.com/wp/wp-content/uploads/2017/04/rule-referencing-5.png)
How to Add Bulk Entries
Sometimes it is necessary to enter multiple entries and the process can be tedious to do one at a time through IIS. Once the original mapping and rule is created, you can then enter additional entries straight into the web.config for the website.
NOTE: PROCEED WITH CAUTION. CREATE BACKUPS OF YOUR WEB.CONFIG BEFORE EDITING.
Locate The Web.Config File
Navigate to the following path:
C:\inetpub\wwwroot\wss\VirtualDirectories\(select the site here)
Edit The Web.Config
1. Once you have the web.config file open locate the following tag
<rewrite> <rewriteMaps> <rewriteMaps name="Old SharePoint">
2. Once you have located this section you can add entries to the web.config by following the format below
<add key="OLD URL" value="NEW URL" />
3. After adding all of your entries you can then save the web.config file.
These entries will take effect immediately without having to do an IIS reset or server restart.
It is as simple as that. Again, by creating the redirects or rewrites you are saving your SEO, maintaining the user experience and preventing a lot of pesky help desk calls. So, if you need to rename a web application, a library or revamp the whole structure of a site, this method will keep your links working and information accessible.
Thank you for reading this post! If you enjoyed it, I encourage you to check out some of our other content on this blog. We have a range of articles on various topics that I think you’ll find interesting. Don’t forget to subscribe to our newsletter to stay updated with all of the latest information on Imaginet’s recent successful projects
![](https://imaginet.com/wp/wp-content/uploads/2022/03/Imaginet_favicon_transparent_165x165.png)
discover more
Secret Manager to Protect Sensitive Data in App Development
Secret Manager to Protect Sensitive Data in App Development September 5, 2024 Secret Manager to Protect Sensitive Data in App Development How you deal with sensitive data is critical to…
Protecting Sensitive Data: Ensuring Privacy from a Data Engineering Perspective
Protecting Sensitive Data: Ensuring Privacy from a Data Engineering Perspective August 29, 2024 Protecting Sensitive Data: Ensuring Privacy from a Data Engineering Perspective In a bank call center, staff members…
Custom Script Setting in SharePoint & OneDrive Removed
Custom Script Setting in SharePoint & OneDrive Removed August 22, 2024 Last week, we published a blog discussing Microsoft retiring SharePoint Add-Ins. In that blog, we briefly discussed how the…
Let’s build something amazing together
From concept to handoff, we’d love to learn more about what you are working on.
Send us a message below or call us at 1-800-989-6022.