How to create a Custom Error page in BBIS

After initial installation of BBIS, any errors generated when accessing your Website will result in an Application Error page or ASP.net page rendered. You can use the steps below to create a Custom Error page, which will present the appropriate Error Code on the page, which can be used to investigate/troubleshoot the error further.
  1. Create a new page.
  2. Add a Formatted Text & Images part to it.
  3. When editing the Formatted Text & Images part, select the Insert tab.
  4. Click the Merge Fields button.
  5. Select the "Error Fields" selection and double click on:
    1. 'Error code'
    2. 'Error description'
    3. 'Error log ID'
Also, feel free to insert any image or extra text you desire.
  1. Click Save
  2. Go to Administration, Sites & Settings, Click on your Site
  3. Scroll down to the Pages section
  4. For the "Error Page" drop-down, select the new error page you created
  5. Scroll to the top and click Save.
  6. After creating the Custom Error page in BBIS, use the details below to assist with adjusting the web.config file so this page is rendered.
Web.config File Settings
In the web.config file, you can adjust options related to your website and its overall performance, including settings for custom error pages.

Custom Error Page Settings
By default, remote users view custom error pages, when specified, and local users view only ASP.NET error pages, which contain rich error information that provides a stack trace. To specify the error pages remote and local users view, you can adjust the <customErrors mode=/> key of the web.config file.
  • To display custom error pages for all remote users and ASP.NET error pages for local users, set the key to <customErrors mode=”RemoteOnly”/>. By default, the key is configured to this setting when you first install Blackbaud Internet Solutions.
  • To display custom error pages for all users, set the key to <customErrors mode=”On”/>. All users view custom error pages, unless one is not specified. If a custom error page is not specified, the ASP.NET error page appears and describes how to view errors remotely.
  • To display only ASP.NET error pages for all users, set the key to <customErrorsmode=”Off”/>. All users view ASP.NET error pages, which contain rich error information.

Environment

 Blackbaud Internet Solutions
 4.0

Was this article helpful?