Customize your email subscription pages

You can design and customize your email subscription pages to provide a way for your contacts to manage their subscription preferences, unsubscribe from your emails, or confirm a specific subscription.

These subscription pages are created as system templates, rather than individual pages. The way they render depends upon the recipient's email preferences.

Please note: because the subscription statuses that appear on your subscription pages depend on the contact who navigates to them, you cannot include a public link to a subscription page on your website. Instead, contacts must navigate to one of your subscription pages via a link in one of your sent emails (e.g., a URL in the footer of one of your marketing emails).

Subscription page domain

Subscription preferences pages are hosted on your primary marketing email domain. If there's no primary marketing email domain connected but you've connected a secondary marketing email domain, your subscription preferences page will be hosted on the secondary domain instead.

If no marketing email domain is available, preference pages will remain hosted on a HubSpot email domain (e.g., hs-sites.com).

Edit subscription page templates

To edit your subscription page templates:

• In your HubSpot account, click the settings settings icon in the top navigation bar.
• In the left sidebar menu, navigate to Marketing > Email.
• Click the Subscriptions tab.
• For each subscription page, click the dropdown menu and select a template. 
• To edit a subscription page template in the design manager, click Actions > Edit.

• In the design manager, edit your template:
  • If you're using a default template, click Clone template in the banner. In the dialog box, enter a name for your new template, then click Clone template.
  • If you're using a coded template, you'll need to edit the email_subscriptions HubL token. Learn more about the available parameters in the HubSpot CMS Docs.
  • You can add modules to your subscription preferences page to allow contacts to request that their personal data be emailed to them or deleted. This function is required under certain data privacy laws. Learn more in our developer docs. 

• In the upper right, click Publish changes. The template will now be available to select from the dropdown menu in your email settings.
• If you want to preview how your subscription page will appear, return to the Subscriptions tab and click Actions > Preview under the associated page.

Please note: if you notice that null is being added to the URL of any of your subscription pages after you've published them, try removing any third-party JavaScript files or libraries that you've added to your site.

Types of email subscription pages

Your email subscription pages allow your contacts to update their subscription preferences. You can also customize a backup unsubscribe page for unrecognized visitors along with a confirmation page that will be shown once someone unsubscribes. Users in a Marketing Hub Professional or Enterprise account can customize the URL of these subscription pages by connecting a domain for the Email content type.

• Subscription preferences page: this page features a name and description of each subscription type defined in your email settings. Users can choose which type of email communications they want to receive from your organization or unsubscribe from all communications on this page. This page is displayed after a user clicks the Manage preferences link from an email they received.

• Subscription update confirmation page: this page confirms that HubSpot has received a request to update communication preferences for a visitor. This page is displayed after a user saves their preferences on the subscription preference page, or after the user clicks the Unsubscribe from all emails link in an email they received.

• Unknown contact subscription preferences: this page is loaded for visitors who aren't recognized in your contacts database in HubSpot at the time of their visit. These visitors will be shown an error message when visiting the subscription page.