Theme Documentation

How to Set Theme Templates on System Pages

Set theme templates on system pages such as your 404, 500, subscription pages, password prompt, and membership pages.

To set up your system pages, such as your 404, 500, subscription pages, password prompt, and membership pages, check out our video or use this step-by-step guide. 

  • Navigate to the Settings dashboard by clicking the gear icon in your portal header.
  • In the left-hand sidebar, click Tools, Website, and then Pages to access the Pages dashboard.
  • Click the System Pages tab and select the appropriate template for each system page, including the 404 error page, 500 error page, password prompt, and search results.
  • Click the Save button in the bottom left to save your changes.

Next, update your subscription pages by following these steps:

  • Stay in Settings. Then navigate to Tools, Marketing, and finally click Email in the left-hand sidebar.
  • Click the Subscriptions tab and select the templates you want to use for each subscription page, such as the Subscription preference page, Subscription update confirmation page, and Unknown contact subscription preferences (also known as Backup Unsubscribe).
  • Click the Save button in the bottom left to save your changes.

Finally, if your theme comes with membership templates that you want to use for private content, follow these steps:

  • Navigate to Tools, Website, then click Private Content in the left-hand sidebar.
  • Click the Pages tab and select the appropriate template for each membership page.
  • Click the Save button in the bottom left to save your changes.

Once done with your selections, click the Save button in the bottom left.


Understanding System Page Templates

System pages serve as the backbone of your website’s user experience, handling critical interactions when users encounter errors, manage subscriptions, or access protected content. Unlike your regular website pages that you build with the page editor’s drag-and-drop functionality, system pages require pre-designed templates that automatically display when specific conditions are met.

When selecting templates for your system pages, consider your site’s overall design consistency. Your 404 and 500 error pages should maintain your brand’s visual identity while providing helpful navigation options to guide users back to your main content. The template you choose should include clear messaging and links to your most important pages, preventing visitors from leaving your site after encountering an error.

For subscription-related pages, your template selection directly impacts email marketing compliance and user experience. The subscription preference page template should make it easy for contacts to update their preferences without fully unsubscribing, while the confirmation page template should clearly communicate that their changes have been saved. This reduces confusion and helps maintain your email list quality.

Pro tip: After applying new system page templates, test each one to ensure they render correctly on both desktop and mobile devices. You can trigger your 404 page by visiting a non-existent URL on your domain, and preview subscription pages by accessing them through your email marketing tools.

If your theme includes membership page templates, these work specifically with HubSpot’s private content feature to control access to premium content. Unlike standard pages that use the page editor, membership pages rely entirely on the template’s built-in structure, so choose templates that align with your content strategy and provide clear instructions for users to gain access.