Skip to content
BETA

Set up a customer portal (BETA)

Last updated: October 6, 2021

In Beta

Applies to:

Service Hub Professional, Enterprise

Give customers control over their communication with your company using a customer portal. A customer portal is a home behind a login where customers can view, open, and reply to their support tickets. Typically, customers can access the customer portal via the knowledge base, but you can also share a link to the portal directly with your customers.

Only conversations that are associated with a ticket will appear in the customer portal; this includes messages sent to a chat, Facebook Messenger, form submission, or connected team email channel. Emails sent to or from an email address that is not connected to the conversations inbox will not appear in the customer portal.

You must have Customer Portal settings access to set up the customer portal. This setting can be turned on in your Users & Teams settings on the Account tab

Set up a customer portal

Before you turn on your customer portal, you need to connect a domain, set up your login and authentication method, and customize your consent to process language. You can also manage the customer portal's branding, preview the ticket listing and ticket detail page templates, and add a support form to your customer portal.

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to Website > Customer Portal.
  • Enter a page title. This is the title that will appear in the browser tab when customers are logged into the customer portal.

Connect a domain

The customer portal uses the same domain as your knowledge base. You can edit the URL slug in your customer portal settings. If you don't already have a domain set up for your knowledge base, in your Customer Portal settings, click Manage Domain to navigate to the domain manager and connect a domain to HubSpot.
 

Please note: you cannot use the default hs-sites domain to host your customer portal.

customer-portal-domain-and-language


The customer portal will appear in the primary language set for your domain. If you change your domain's language in your Domains & URLs settings, the customer portal language will also update. Click Manage domain language to make changes to your domain. Learn more about HubSpot's language offerings.

Set up login and authentication

Your customers must login to access their customer portal. You can either require member registration to access the portal or provision access using single sign-on (SSO).

Require member registration

  • When requiring member registration, you can either allow customers to create their own login or give access to a specific list of contacts.
    • To allow users to create their own login, navigate to your private content settings:
      • In your HubSpot account, click the settings icon settings in the main navigation bar.
      • In the left sidebar menu, navigate to Website > Private Content.
      • Click the Choose a domain to edit dropdown menu and select the domain where your customer portal is hosted.
      • Select the Allow self-registration checkbox. This will allow anyone to register and create their own login for the customer portal.
    • If you only want to give access to a specific list of contacts, navigate back to your Customer Portal settings:
      • In your HubSpot account, click the settings icon settings in the main navigation bar.
      • In the left sidebar menu, navigate to Website > Customer Portal.
      • In the Customer Portal Access section, select the Give specific contacts access with lists option, then click the dropdown menu and select the lists to give access to.

give-lists-access-to-cp

Provision access using single sign-on (SSO)

SSO allows your customers to use a single set of login credentials in your external app and customer portal.

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to Website > Private Content.
  • In the Single Sign-on (SSO) section, click Set up SSO. Your IT administrator can set up a HubSpot application in your identity provider account, such as Google or Okta, and provision access to your customers there. SAML and JWT-based applications are supported for the customer portal. Learn more about setting up SSO.
  • When SSO is configured, you can choose to allow all SSO users to access the customer portal, or give access to a specific list of contacts:
    • In the left sidebar menu, navigate to Website > Customer Portal.
    • In the Control audience access section, select either Allow all SSO users or Give specific SSO users access with lists.

control-sso-audience-access

Customize consent to process language (optional)

If you're allowing customers to self-register to access their customer portal, you should configure your consent notice to let them know how you will be using their data.

Please note: while these features live in HubSpot, your legal team is the best resource to give you compliance advice for your specific situation.

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to Website > Customer Portal.
  • In your Customer Portal settings, click Manage consent to process.
  • You'll be brought to your Private Content settings. Click the Choose a domain to edit dropdown menu and select the domain where your customer portal is hosted.
  • In the Consent to process data section, click Edit explicit consent content.
  • In the Notice and consent panel, update the consent to process text or consent to process checkbox label, then click Save. You can also link out to your legal team's external resources from the Notice and consent text, if applicable.

edit-consent-to-process-text

This will only update the consent to process text for your customer portal. Learn how to set default notice and consent text for other HubSpot tools.

Set up ticket filters

Using filters, you can customize which tickets appear in the customer portal. Only the tickets that meet the filter criteria selected here will appear in the customer portal. For example, if you only want the tickets created in your support pipeline to appear, you can set up a filtering rule to only include tickets in a specific pipeline.

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to Website > Customer Portal.
  • Click Configure ticket properties.
  • In the right panel, select a ticket property to filter by, then select an option for the filter criteria.
  • Click Save.

set-up-pipeline-criteria

Keep in mind that when a contact is associated with a ticket, any conversations associated with that ticket will appear in the customer portal, even if that contact was not a direct recipient on the thread. To verify which conversations will appear in the customer portal, use the Conversations card in the ticket record's right sidebar. It is recommended to use notes and comments to communicate internally on your tickets, or set up filtering rules to filter out any internal communication from the customer portal.

Customize ticket templates and branding

When a customer logs into their customer portal, they can view a list of their tickets on the listing page, then click into individual tickets to view the associated conversation. You can preview the ticket listing and detail page templates, review your branding settings, or add a support form to your portal so visitors can submit a new ticket.

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to Website > Customer Portal.
  • Click the Template tab.
  • Next to the template that you want to review, click Edit.

edit-listing-detail-template

  • In the theme previewer, use the styling options to make sure your customer portal's appearance stays consistent with the rest of your website. Learn more about editing theme style settings.

Please note: if you make changes to the theme styles, these changes will apply to the ticket listing, ticket detail, and ticket form page.

  • The customer portal inherits the logo, favicon, and colors that you select in your account's branding settings. To access your branding settings from the customer portal settings, click Manage customer portal branding. Currently, there are no additional customization options for the customer portal.
  • If you want customers to access the knowledge base from their customer portal, select the Show link to Knowledge Base in Customer Portal checkbox. Your knowledge base must be on a connected domain with at least one published knowledge base article.
  • You can also give customers access to the customer portal from your knowledge base template:
    • In your HubSpot account, navigate to Service > Knowledge Base.
    • In the top right, click Customize template.
    • In the left panel, on the Content tab, click Navigation bar.
    • Click to toggle the Show customer portal link ON. 

go-to-customer-portal

When a customer is on the knowledge base, a Go to [customer portal name] hyperlink will appear in the top right. 

Add a support form to your customer portal

You can add a support form to your customer portal so that when a visitor is logged in, they can submit a new support request from their customer portal. A File a Support Ticket link will appear in the customer portal navigation menu.

  • In your Customer Portal settings, click the Templates tab.
  • In the Connect a Support Form section, click the Forms dropdown menu and select a form.

connect-a-support-form

You must select a form that includes ticket properties and that is connected to the conversations inbox. To add ticket properties to your form, you can either create a form using the Support form template, or turn on ticket properties in the form builder. To turn on ticket properties for a form:

  • In your HubSpot account, navigate to Marketing > Lead Capture > Forms.
  • Hover over the form and click Edit.
  • In the left panel of the form editor, click to toggle the Ticket properties switch on.

automatic-ticket-creation

  • If you have multiple inboxes, in the dialog box, click the dropdown menu and select an inbox, then click Save.

A ticket will be created for each form submission, which will appear in the customer's own customer portal in addition to your conversations inbox.

Turn on a customer portal

Once you have completed the set up steps, you can turn on your customer portal by clicking to toggle the switch ON.

turn-on-customer-portal-switch
Give contacts access to the customer portal

To access the customer portal, you can either share the link to the portal with your customers or they can access the portal via the knowledge base. To view your customer portal:

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to Website > Customer Portal.
  • In the top right, click View Customer Portal.

Depending on the login and authentication method you selected, before a customer can access their customer portal, they may need to set up their login credentials.

  • If customers are able to self-register, a Register here link will appear below the login credential fields.

register-here-for-CP

  • If only a specific list of contacts have access, an email will be sent to them so they can set up their login.

Please note: if you are logged into your HubSpot account when you visit the customer portal, you will not have to login to view the ticket listing page.

When your visitors log in to their customer portal, they can view all of their open and closed tickets on the ticket listing page, and filter and search for existing tickets.

The following ticket properties are visible in the customer portal by default and cannot be customized at this time:

  • ID
  • Subject
  • Create date
  • Last activity date
  • Status (Open or Closed)

tickets-view-customer-portal

To view more ticket details and the associated conversations, your customer can click the name of a ticket to open the ticket details page. They can also reply to a closed ticket if they need to re-open the conversation.

chatting-from-customer-portal
If the customer needs to file a new ticket, they can click File a Support ticket. This will take them to the ticket form that you created so they can submit a new issue.

file-support-ticket-from-cp

To log out of their portal, the customer can click Sign out in the top right.