Sign in with Microsoft
Sign in or create an account.
Select a different account.
You have multiple accounts
Choose the account you want to sign in with.


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




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.


    • Client makes a request to

    • IIS with ARR receives the request to

    • ARR uses URL Rewrite to change the URL to

    • The updated URL is then sent to the SharePoint web application.

This scenario is NOT SUPPORTED.


    • Client makes a request to

    • IIS with ARR receives the request to

    • ARR uses URL Rewrite to change the URL to, and then sends the new URL to the server

    • SharePoint receives the new URL and processes it as

This scenario is SUPPORTED.


    • Client makes a request to

    • IIS with ARR receives the request to

    • ARR uses URL Rewrite to create a redirect to, and then returns the HTTP redirect (for example, 301 or 302) to the client

    • Client receives the redirect, and then makes a new request by using the new URL:

    • SharePoint receives the request, and processes it as usual.

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.

Need more help?

Expand your skills


Get new features first


Was this information helpful?

What affected your experience?

Thank you for your feedback!