Supportability of rewrites and redirects in SharePoint 2016, 2013, 2010, and 2007

Applies to: SharePoint Server 2016SharePoint Server 2013SharePoint Server 2010


This article discusses how supportability is affected if you configure URL rewrite and redirect scenarios in Microsoft SharePoint Server by using any URL manipulation tool, such as Internet Information Services (IIS) URL Rewrite.

Some of these tools may function as expected when you use them to configure a URL rewrite or redirect that is related to SharePoint. However, when you evaluate the supportability for any URL manipulation tool that you use together with SharePoint, you should consider that Microsoft has not thoroughly tested all possible implementation scenarios that use such tools.

Important Microsoft cannot endorse these tools or provide support for their implementation when they are used in conjunction with SharePoint.

More Information

The following information is provided to show how SharePoint functions in general when you use URL rewriting and redirection.

Common URL components




Query string

HTTP /apps/default.aspx ?user=admin

There are two main types of URL changes: Rewrite and Redirect.

Rewriting modifies the incoming URL, the outgoing URL, or both

Redirection uses HTTP status codes such as 301 or 302 to redirect the client to a different location. This involves an additional client round trip.

Microsoft does not support implementations of any URL modification in Microsoft SharePoint Server 2016, Microsoft SharePoint Server 2013, Microsoft SharePoint Server 2010, or Microsoft Office SharePoint Server 2007.

Example Scenarios

Note All the scenarios in this section use the Application Request Routing (ARR) server as the proxy, and use URL Rewrite to change the URL.

This scenario is NOT SUPPORTED.

This scenario is SUPPORTED.

This scenario is SUPPORTED.

For more information, see the "Reverse Proxy Publishing" section in the following TechNet topic:

   Plan Alternate Access Mapping (Office SharePoint Server)

Although the topic mentions Office SharePoint Server 2007, it also applies to SharePoint 2016, SharePoint 2013 and SharePoint 2010.