Skip to content

Create codeless custom behavioral events

Last updated: August 28, 2023

Available with any of the following subscriptions, except where noted:

Marketing Hub Enterprise

Custom behavioral events allow you to track information unique to your business. Clicked element and Visited URL events can be created without code with the HubSpot Chrome extension.

A clicked element event tracks when an anonymous visitor or HubSpot contact clicks a specific element on your website. For example, track when a free demo CTA or PDF download link is clicked. Clicked element events can only be created and tracked on pages that have the HubSpot tracking code installed. Visited URL events record when an anonymous visitor or HubSpot contact visits a specific URL on your website.

A single Visited URL event can be set to track up to 30 different URLs, and a single Clicked Element event can be set up to track up to 30 different clicked elements. 

Please note:

  • The instructions in this article are for the new custom behavioral events tool, which replaces the previous behavioral events tool. Any events created in the legacy tool will continue to work, and you can still manage and analyze those events in the legacy tool.
  • Legacy events cannot be migrated to the new events tool. Instead, it's recommended to recreate your legacy events in the new tool, as new custom events provide more flexibility with event properties. For example, with legacy events you'd need to create multiple events to track separate campaigns, but now a single custom behavioral event can track multiple campaigns.

 

Once you've created your events, learn how to analyze events in the analytics and reporting tools. You can also create and manually track custom events.

Create events with the Chrome extension

Install the event Chrome extension

  • In your HubSpot account, click the settings settings icon in the main navigation bar.
  • In the left sidebar menu, navigate to Tracking & analyticsTracking Code.
  • Click Install event chrome extension.

  • Click Download.

  • You'll be redirected to the HubSpot Analytics extension in Google Chrome web store. In the upper right, click Add to Chrome.

  • In the dialog box, click Add extension.
  • Once the extension has been installed, it will appear as an orange sprocket icon sprocket in your Chrome browser toolbar.

Create a visited URL event with the event Chrome extension

  • Navigate to a web page with your HubSpot tracking code installed.
  • In your Chrome browser toolbar, click the sprocket icon.
  • In the dialog box, click Create an event.
  • Add your event name and optionally add a description. Click Next. 
  • Select Visited URL, than click Next.



  • In the Page URL field, enter the URL that you want to track visits to.
  • In the Tracking name field, enter a name for the page. This name will be available within the event property data under the property called Tracking Name. Click Next.
  • Click Done.

HubSpot will then begin to track the event. Learn how to analyze the event in HubSpot.

Create a clicked element event with the event Chrome extension

  • Navigate to a web page with your HubSpot tracking code installed.
  • In the Chrome browser toolbar, click the sprocket icon.
  • In the dialog box, click Create an event.
  • Add your event name and optionally add a description. Click Next. 
  • Select Clicked element, than click Next.



  • To select an element on the page to track, click the selector icon. Select an element on the page to track. You can add multiple clicked elements to a single event.
  • Add a Tracking name. This name will be available within the event property data under the property called Tracking Name.
  • In the example below, the clicked element event will track clicks on the key aspects link.


HubSpot will then begin to track the element(s). Learn how to analyze the event in HubSpot

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.