Brightspot CMS User Guide

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.

This topic explains how to configure error responses; however, you must first create the pages that correspond to these error responses before being able to apply the error responses. See Error pages for more information.

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.

    Error handlers.jpg Error handlers.jpg
    Error handling for 4xx Client Error

  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.

Previous Topic
Working with custom <head> elements
Next Topic
Error page
Was this topic helpful?
Thanks for your feedback.
Our robust, flexible Design System provides hundreds of pre-built components you can use to build the presentation layer of your dreams.

Asset types
Module types
Page types
Brightspot is packaged with content types that get you up and running in a matter of days, including assets, modules and landing pages.

Content types
Landing pages
Everything you need to know when creating, managing, and administering content within Brightspot CMS.

Admin configurations
A guide for installing, supporting, extending, modifying and administering code on the Brightspot platform.

Field types
Content modeling
Rich-text elements
A guide to configuring Brightspot's library of integrations, including pre-built options and developer-configured extensions.

Google Analytics
Apple News