How to customize error pages

Last Updated: June 06, 2014

Configure the 404 and 500 error pages for your HubSpot-hosted website and manage your visitors' experience when they encounter a system error or broken link on your website.

Why should I customize my 404 and 500 error pages?

In an ideal world, you would never need a 404 or 500 error page. Links would never break, files would stay in one place, and visitors would seamlessly navigate around your website by clicking on links that work every tie. But visitors on your website will from time to time encounter an error, which means they will stumble upon the dreaded 404 or 500 error page.

While you can take steps to correct these errors on your site when you find them, it's also important to ensure that you have customized 404 and 500 error pages in place. This will help your visitors find what they're actually looking for in the event that they encounter these errors, while offering text and images that are consistent with your brand.

What is a 404 error?

A 404 error is encountered when a page that a visitor was trying to reach cannot be found. This could be caused by the page having been moved to a new URL, or removed from the website entirely.

What is a 500 error?

A 500 error is encountered when a page that the visitor was trying to reach exists, but there was an unexpected problem loading the page from the server. This is typically a temporary issue with the page that will be resolved when the server error has been resolved.

Instructions for setting up a custom error page


1. Create new Template Layouts in Template Builder for your 404 and 500 error pages

Use the Template Builder to create new Template Layouts for your 404 and 500 error pages. Follow these instructions to learn how to use Template Builder.


Best Practices for an Error Page Template Layout

  • Include your site's navigation menu on your error pages. Visitors need to know they can move quickly off of the page.
  • Include an apology of some sort for the inconvenience. These aren't totally essential from a usability stand point, but they can go a long way to calm a visitor who might otherwise be frustrated. Feel free to be all quirky with yo bad self.
  • Offer a link to bring the user back to the page they were just on, back to your home page, or to some other useful location (such as "Contact Support) when they hit your error page. Give them a logical next step to take that will help them get to where they were trying to go.

2. Set your Error Page Options in Content Settings

Go to Content > Content Settings.

Choose the 404 and 500 Error Page Template Layouts you want to use from the drop-down menu.


Next Article: How to use the URL mapping tool to redirect pages


Table of Contents

    Get feedback from marketing peers and experts on
    Check out Premier Services