Use a Sitefinity CMS WebForms page as a custom error page

If you plan on using a Sitefinity CMS page as a custom error page, you must take care of setting the proper response status code. By default, Sitefinity CMS will return status code 200 for any page that it resolves successfully. For example, if you are handling error status code 404 (resource does not exist) when serving your custom error page you should return status 404, to ensure compliance with SEO best practices.

To configure your Sitefinity CMS WebForms custom error pages to return the desired status code, follow the instructions described in this article.

To do this, perform the following:

  1. Add new user control to your Sitefinity CMS web application and name it accordingly, for example NotFoundStatusCodeSetter.
  2. Go to the code-behind and add the following code:

    The code above sets the response status code to 404 only when viewing the page on the site frontend. You can still edit your page in the backend, thanks to the usage of IsDesignMode method. You must add the status code at a latest possible moment - in this sample, in the Render event.  

  3. Register the user control in your Sitefinity CMS toolbox.
    For more information, see Register a new widget in the backend
  4.  Create a page in Sitefinity CMS, that you want to use as a custom error page for the 404 status code and add the NotFoundStatusCodeSettercontrol to it.
  5. Publish the page.

As a result, the proper response status code will be returned when serving your custom error page.

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

Web Security for Sitefinity Administrators

This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

Was this article helpful?