Error Pages
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.
Element Name |
Description |
||
---|---|---|---|
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.
|
||
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.
Element Name |
Description |
||
---|---|---|---|
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.
|
||
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:
|
||
Path type |
Under Default Page, select one of the following options from the Path type drop-down list:
|
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. |