Struggling to understand how your prospects actually engage with your content?
If you’re using HubSpot but can’t clearly track things like CTA clicks, form submissions on external pages, or in-app interactions, your campaign results will always leave questions unanswered.
Without reliable behavioral signals tied to real contacts, accurate attribution becomes nearly impossible.
If you’re relying solely on HubSpot’s default analytics, you’re probably missing important user actions that influence conversions. While HubSpot’s newer tools have evolved, the legacy events tool still fills critical gaps, especially for web interactions that are manually tracked or rooted in older tech setups.
In this guide, you’ll learn exactly how to use the legacy events tool in HubSpot Reports.
You’ll get a clear breakdown of what it does, when to use it (and when not to), common setup mistakes, and how to incorporate these events into your reports for better decisions.
Tracking Custom Behaviors in HubSpot with Legacy Events
The legacy events tool in HubSpot is a manual yet powerful way to capture user behavior that standard analytics often misses.
Think of it as a custom event tracker that ties specific actions back to contact records, so long as those users are cookied or known in your CRM.
You’ll find it nested under Reports > Analytics Tools > Legacy Events in older HubSpot accounts. For newer portals, you may need admin-level permission to access this section.
Why Use It: HubSpot’s default tracking won’t capture certain interactions, such as PDF downloads, external link clicks, or behaviors in JavaScript-based components. The tool lets you define each event manually and connect it to your reporting.
Once configured, it logs user actions, including anonymous ones, and stores those logs against matching contacts when available. While HubSpot has more modern journey analytics tools, many teams still rely on legacy events to maintain continuity in older setups.
How It Works Under the Hood
At its core, the legacy events tool relies on a simple concept: JavaScript snippets that push event data into HubSpot, tagging those interactions to the correct people.
Steps Behind the Scenes:
- Create an event in HubSpot with a clear trigger, like a button click or page visit.
- HubSpot generates a unique ID and script.
- Insert that script into your site and configure it to fire when the specific action occurs.
- When the action triggers, HubSpot.trackEvent() runs, sending the signal to HubSpot.
- HubSpot matches the interaction to a contact when possible and logs it in reports.
You control several inputs: event name, action type, optional values, and post-event behavior. Whether the action updates a property, enrolls a user in a list, or triggers a workflow, it depends on your setup.
For larger websites, you can track similar events across multiple pages under a single event label, providing a unified view of engagement across your funnel without duplicating effort.
Main Uses Inside HubSpot
The legacy events tool gives you control over high-value interactions. Common uses include:
Tracking Website Click Interactions
You need to know which CTAs drive engagement, not just page traffic. The tool lets you track specific button or link clicks, even when multiple clickable elements exist.
Why It’s Valuable: Default tools may not distinguish multiple interactive elements. Legacy events track exactly which CTA attracts attention.
Example:
Monitor demo intent by creating a “Demo Button Clicked” event. Each click fires the script, and you can filter the report by lifecycle stage to see clicks from qualified leads.
Measuring Engagement With Custom Web Elements
Custom videos, sliders, or third-party widgets might be invisible to native analytics.
Why It’s Valuable: It tracks subtle behaviors that indicate interest, such as watching a demo or using a pricing slider.
Example:
Add a “Video Play Initiated” event on your homepage walkthrough video. Compare engagement before and after updates, tied to CRM activities like form submissions.
Capturing Conversions on External Pages
Not all users go through HubSpot-hosted pages. Microsites, subdomains, or client-facing tools need tracking too.
Why It’s Valuable: Without this tool, HubSpot may miss interactions outside its CMS, even with embedded forms or CTAs.
Example:
On a non-HubSpot pricing calculator, create an “Estimate Submitted” event. Every submission funnels into your core reports and contact records.
Common Setup Errors and Wrong Assumptions
Manual tracking has pitfalls. Avoid these mistakes:
Missing the HubSpot Tracking Code:
Events won’t work without it. Verify every tracked page includes the main HubSpot script.
Pasting the Wrong Event Script:
Using an outdated or incorrect snippet prevents events from firing. Always use the latest script after saving your event.
Expecting Anonymous Data to Match Contacts:
Events from unknown users will not tie to contacts. Some actions appear in aggregate until they are identified.
Triggering Events Multiple Times:
Without logic, one action might fire multiple times, inflating counts. Limit event firing to once per action or session.
Step-by-Step Setup or Use Guide
Ensure you have Marketing Hub Professional or Enterprise, and that the HubSpot tracking code is installed across relevant pages.
Step 1: Open the Legacy Events Section
Navigate to Reports > Analytics Tools > Legacy Events.
Step 2: Click “Create Event”
Opens the event configuration form.
Step 3: Choose the Event Type
Select visited URL, clicked element, or custom JavaScript.
Step 4: Define the Condition
For clicks, use CSS class or ID. For URLs, define the path. For custom actions, name the event.
Step 5: Customize Optional Settings
Set property values, limit repeats, or trigger workflows.
Step 6: Copy the Event Script
Use the HubSpot-generated hubspot.trackEvent(‘eventId’) snippet.
Step 7: Add the Script to Your Site
Place it with page logic or event listeners for the action.
Step 8: Test the Event
Take the action on the live site and confirm it logs in the Legacy Events dashboard.
Measuring Results in HubSpot
Return to Reports > Analytics Tools > Legacy Events to monitor performance. Key metrics include:
- Total Event Count: How often the action occurred.
- Unique Contacts Triggered: Number of distinct users per event.
- Conversion Ratio: Percentage of users engaging relative to total sessions.
- Performance Trends: Time-based views for increases or drops.
- Attribution Linkage: Combine with UTM or campaign parameters to trace engagement sources.
Use these metrics in custom reports filtered by lifecycle stage, campaign, region, or properties. Export raw data to CSV or a BI dashboard for deeper revenue-focused analysis.
Short Example That Ties It Together
Track if the “Get Pricing” button converts visitors into leads:
- HubSpot tracking runs across your site.
- Define a new legacy event: “Pricing Button Click.”
- Input the CSS selector.
- Save and place the script where the button fires.
- Test the event to confirm logging.
- Analyze after a week: 12% of clicks lead to form submissions.
- Compare clicks, outreach, and conversions to identify the most effective campaigns.
How INSIDEA Helps
Setting up event tracking can be done on your own, but it can be time-consuming.
At INSIDEA, we help HubSpot users implement reliable event tracking to connect actions to business insights. This includes:
- HubSpot Onboarding: Establish a clean foundation for data and workflows.
- Operational HubSpot Management: Keep systems synced and reporting-ready.
- Workflow and Automation Support: Align actions with lead behavior.
- Reporting Improvements: Track actions that impact conversions.
For users who want events tied to sales intelligence or clearer dashboards, INSIDEA can help. We support HubSpot consulting services and assist companies looking to hire HubSpot experts for setup and optimization.
Consistent, thoughtful event tracking ensures HubSpot reports reflect real engagement, not just clicks. Proper setup turns every interaction into actionable insight.
