Use system templates to customize error, subscription, and password prompt pages

Last updated: August 3, 2018

Applies to:

Marketing Hub: Basic, Pro, Enterprise

Systems templates are used for certain types of pages generated automatically by HubSpot.

System page templates in HubSpot

  • Error page: 404 and 500 error pages to let your users know that they have reached a page that does not exist or a technical issue has occurred.
  • Password prompt page: a password prompt page for any content you've locked with a password.
  • Subscription page: the subscription preferences page where your email recipients can manage which email types they are subscribed to and unsubscribe from all emails.
  • Backup unsubscribe page: a page that will appear for email recipients who are trying to unsubscribe, if HubSpot can not determine their email address.
  • Subscriptions update page: the confirmation page that appears when an email recipient updates his or her subscription preferences.

In addition to the standard HubSpot modules, each type of system template has a special module that can only be added to that type of template. For example, a password prompt module is only available on when creating a password prompt template.

Please note: custom system templates can be selected for any domain you have connected as a primary domain for one of your content tools in HubSpot (Email, Blog, Landing Pages, Website Pages). Any additional domains connected in the domain manager will use the system templates specified as Default for all domains in your settings.

Best practices for creating system templates

System templates are an opportunity to create goodwill with your users in a non-ideal situation:

  • Use 404 templates to suggest other options or provide a search module.
  • 500 error pages present an opportunity to use humor to diffuse a frustrating situation. 
  • A classic example of this is Twitter's "fail whale", which surfaces whenever Twitter is over capacity or has some other type of outage.
  • Subscription pages give you another opportunity to engage with your recipients. For example, you can inform your users how they can opt back in to particular email types or all emails on a subscriptions update page, in cases where they unsubscribe but later change their mind.

  • In your HubSpot Marketing Hub Basic, Professional, or Enterprise account, navigate to Marketing > Files and Templates > Design Tools.
  • Click Create a new file at the upper right of the dashboard. In the dialog box that appears, select Drag and drop.
Create System template
  • Click the Template type dropdown and select one of the System templates. Next, give your template a file name. When you're done, click Create.

Customize your system template

Once you've created your system template, you can proceed to structure and customize it. You can attach stylesheets to your system template at the template level.

To customize the default content that appears in the template modules, click a module and scroll down to the Default content section in the right Edit sidebar. The options you see in this section may differ depending on the specific type of module.

You won't use system templates to create landing pages or website pages. Instead, the system uses these templates to create and display pages that are specific to the user; therefore, the default content defines what the end user sees.


Apply your system templates in your settings

After customizing your default templates, you can apply them to your content in your HubSpot settings.

Select your error and password prompt page templates

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar, navigate to MarketingWebsite pages.
  • Click the System Pages tab. In the Custom system pages section, use the corresponding dropdown menus to choose your 404 error page500 error page, and Password prompt page templates.
  • When you're done, click Save at the bottom left.
HubSpot Help article screenshot

Select your email subscription page templates

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar, navigate to Marketing Email in the left sidebar menu.
  • Click the Subscriptions tab. Here, you can select your Subscription preferenceUnsubscribe backup, and Subscription update confirmation page templates. When you're done, click Save at the bottom left.
HubSpot Help article screenshot

Was this article helpful?

If you still need help you can get answers from the , or to contact support.