Error Pages

Article
08/31/2016

Applies To: Windows Server 2012 R2, Windows Server 2012

Use the Error Pages feature page to manage a list of custom HTTP error messages.

Sort the list by clicking one of the feature page column headings or select a value from the Group by drop-down list to group similar items.

Related scenarios

In this document

UI Elements for Error Pages

The following tables describe the UI elements that are available on the feature page and in the Actions pane.

Feature Page Elements

Element Name	Description
Status Code	Displays the HTTP status code to which the error page applies.
Path	Displays the path of the error page if you choose the File path type, or the URL of the custom error page if you use either the Execute URL or the Redirect path type.
Type	Displays the path type (file, execute URL, or redirect URL) of the error page.
Entry Type	Displays whether the item is local or inherited. Local items are read from the current configuration file, and inherited items are read from a parent configuration file.

Actions Pane Elements

Element Name	Description
Add	Opens the Add Custom Error Page dialog box in which you can add a custom error to the list of HTTP errors.
Edit	Opens the Edit Custom Error Page dialog box in which you can edit the selected custom error.
Change Status Code	Enables the Status Code field of the selected list item so you can change the status code to which the error page applies.
Remove	Removes the item that is selected from the list on the feature page.
Edit Feature Settings	Opens the Edit Error Pages Settings dialog box in which you can configure settings that apply to the entire Error Pages feature.

Add or Edit Custom Error Page Dialog Box

Use the Add Custom Error Page and Edit Custom Error Page dialog boxes to configure IIS to return a custom error message whenever a specific HTTP error occurs.

Status code

Type the HTTP status code (and optional sub-status code) to which the custom error page applies.

Insert content from static file into the error response

Select this option when the error page should include static content, such as from an HTML file. In the corresponding File path box, type or browse for the physical path of the static file.

Caution
If the file that you configure in the File path box is not static content, such as a .aspx file, the code will be displayed instead of running when the response is returned.

Browse

Opens the file menu from which you can browse for the static file.

Try to return the error file in the client language

Select this option when the error should be returned in the client language (if possible). When you select this check box, click the Set button to configure the path.

Set

Opens the Set Localized Custom Error Path dialog box from which you can configure the path of localized error files.

Note

This button is enabled only when you select Try to return the error file in the client language.

Execute a URL on this site

Select this option when the error page should include dynamic content, such as from an ASP file. In the corresponding URL (relative to site root) box, type the relative path to the custom error.

Respond with a 302 redirect

Select this option when you want the client to be redirected to a different URL. In the corresponding Absolute URL box, type the full URL to which the client is redirected.

Edit Error Pages Settings Dialog Box

Use the Edit Error Pages Settings dialog box to return a default error message any time an HTTP error occurs for which there is no predefined error page.

Custom error pages

Under Error Responses, select this option to respond with only custom error pages for both local requests and for requests that are made from other computers.

Detailed errors

Under Error Responses, select this option to respond only with detailed errors for both local requests and for requests that are made from other computers.

Caution
Detailed error messages might display sensitive server information to the client.

Detailed errors for local requests and custom error pages for remote requests

Under Error Responses, select this option to display detailed errors for local requests and custom errors for requests that are made from other computers.

Path

Under Default Page, type or browse for the path of the default error page. Depending on the option you select from the Path type drop-down list, the value that you type in the Path field should be one of the following:

If you select File, specify a physical path.
If you select Execute URL, specify a URL that is relative to the site root URL.
If you select Redirect, type a URL.

Path type

Under Default Page, select one of the following options from the Path type drop-down list:

File: The default error is static content, such as from an HTML file.
Execute URL: The default error is dynamic content, such as from an ASP file.
Redirect: The default error is at a redirection URL.

Set Localized Custom Error Path Dialog Box

Use the Set Localized Custom Error Path dialog box to configure the path of localized error files.

Element Name	Description
Root directory path	Type the physical path of the root directory of the localized error files. The root directory path is the part of the path before the locale directory, such as EN-US. For example, if the full path of the error files for the EN-US locale is d:\errors\EN-US\messages\404.htm, you type d:\errors.
Browse	Opens the file menu from which you can browse for the path.
Relative file path	Type the relative physical path of the localized error file. The relative file path is the part of the path after the locale directory, such as EN-US. For example, if the full path of the error files for the EN-US locale is d:\errors\EN-US\messages\404.htm, you type \messages\404.htm.