Skip to content

Commit 8a4d1b5

Browse files
Merge pull request #299200 from jeffwmartinez/jefmarti-cep
adding error page faq
2 parents 0069697 + 80a8695 commit 8a4d1b5

File tree

1 file changed

+11
-4
lines changed

1 file changed

+11
-4
lines changed

articles/app-service/configure-error-pages.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.date: 10/14/2024
88
ms.author: jefmarti
99
---
1010

11-
# Configure error pages on App Service (preview)
11+
# Configure error pages on App Service
1212

1313
This article explains how to configure custom error pages on your web app. With App Service you can configure an error page for specific errors that will be presented to users instead of the default error page.
1414

@@ -23,7 +23,7 @@ For this example, we're uploading and testing a 403 error page to present to the
2323
Select the error code that you'd like to upload an error page for and click **Edit**. On the next screen, click the folder icon to select your html file. The file must be in html format and within the 10 kb size limit. Find your .html file and click on the **Upload** button at the bottom of the screen. Notice the Status in the table updates from Not Configured to Configured. Then click **Save** to complete the upload.
2424

2525
## Confirm error page
26-
Once the custom error page is uploaded and saved, we can trigger and view the page. In this example, we can trigger the 403 error by using an IP restriction.
26+
Once the custom error page is uploaded and saved, we can trigger and view the page. In this example, we can trigger the 403 error by using an IP restriction however you can also trigger a 403 error page by stopping the site.
2727

2828
To set an IP restriction, go to the **Networking** blade and click the **Enabled with access restrictions** link under **Inbound traffic configuration**.
2929

@@ -47,8 +47,15 @@ App Service currently supports three types of error codes that are available to
4747
## FAQ
4848
1. I've uploaded my error page, why doesn't it show when the error is triggered?
4949

50-
Currently, error pages are only triggered when the error is coming from the front end. Errors that get triggered at the app level should still be handled through the app.
50+
Custom error pages are triggered from front end failures. If the error is coming from the app level, it won't trigger or show the configured error page. If you want the error page to show for all requests, check the **Apply to all requests** box under the configured error code. This will show the error page for all requests matching the status code regardless of where it failed. Note, when this box is checked it will override any existing error pages that are configured for the app.
5151

5252
2. Why is the error page feature greyed out?
5353

54-
Error pages are currently a Premium feature. You need to use at least a Premium SKU to enable the feature.
54+
Error pages are currently a Premium feature. You need to use at least a Premium SKU to enable the feature.
55+
56+
3. How can I reference a single error page across multiple apps?
57+
58+
If you need to use the same error page across multiple apps, you can link to your error page hosted in a storage account in your uploaded html file. Upload your error page to a [storage account](/azure/storage/common/storage-account-overview) and add the provided storage URL for your page in an `<iframe>` tag located in the html file uploaded to the app.
59+
60+
61+

0 commit comments

Comments
 (0)