Configuring error responses

You can configure your error handling to cover status codes, status categories, and exception classes. When a visitor encounters an issue, you can specify which page they are taken to and what content they see.

Error handling in Brightspot is configured in the Sites & Settings area.

To configure error handling:

1. Click menu > Admin > Sites & Settings.
2. In the Sites widget, select the site for which you want to configure this setting.
3. Click search, located to the left of more_horiz, and type error.

4. Click add_circle_outline Add Content Error Handler.

   You have three options available for error handling:

   • Status Codes - enter the error status code you would like handled with this error handler.
   • Status Categories - expand the menu and select either 4xx Client Error or 5xx Client error depending on which category for which you are creating the error handler.
   • Exception Classes - enter the Java class for which you are creating the error handler. For instance, you could enter IllegalArgumentException to have that specific exception handled by this error handler.
5. Using the descriptions above, select one of the options and enter the data for that type of error.
6. In the Content field, click searchto open the content picker to choose the page you want visitors to be taken to if they encounter any of the error types configured above.

7. Complete steps 3–5 for each additional type of error you want handled in this site.

   

8. Click Save.

   Now when a visitor encounters any of the errors you specified, they are taken to the desired page. In the above image, whenever a visitor encounters a 4xx Client Error, they are taken to the 404 Error Page specified in the Content field.