Theme Documentation

How Do I Change the Default Text on System Pages (Search Results, 404, Subscription Preferences, Etc.)?

HubSpot currently does not have an editing experience for system pages. To change default content on system pages, create a Child Theme and edit the templates directly.

If you are using Rubric, however, in this specific theme we created global partials for the body of each system page and added them to a “System Page Globals” template. By creating a page with this template you can access and edit these globals to change the content of your system pages.


Understanding System Page Customization

System pages in HubSpot are automatically generated templates that handle specific user interactions like search results, 404 errors, unsubscribe confirmations, and subscription preference management. Unlike your regular content pages, these system-generated pages don’t appear in your page editor’s drag-and-drop interface, which means you can’t customize their content through HubSpot’s standard editing experience.

When visitors encounter these pages on your site, they’ll see HubSpot’s default messaging and layout, which may not align with your brand voice or provide the user experience you want. This is particularly important for 404 pages, where you might want to guide users back to relevant content, or subscription preference pages, where clear messaging can improve user retention.

The child theme approach gives you complete control over the HTML, CSS, and HubL code that powers these system pages. You can modify everything from the page title and body text to the overall layout and styling. This method requires some technical knowledge, as you’ll be working directly with template files rather than through HubSpot’s visual editor.

For Rubric theme users, the System Page Globals template streamlines this process significantly. Instead of editing code files, you can create a new page using this template and manage your system page content through familiar HubSpot editing tools. This approach lets content editors update system page messaging without developer involvement, making it much easier to maintain consistent messaging across seasonal campaigns or brand updates.

Remember to test your customized system pages thoroughly, especially the subscription preference functionality, to ensure all user interactions continue working properly after your modifications.