Manage Legacy Events in HubSpot

Legacy events are the older, pre-behavioral event tracking system in HubSpot, and understanding how to manage them is essential if you still rely on historical event data for reporting and automation. This guide walks you step-by-step through how to access, review, edit, and clean up those legacy events so your HubSpot reports remain accurate and easy to maintain.

What Are Legacy Events in HubSpot?

Legacy events are tracking assets created before HubSpot introduced the newer behavioral events tool. They continue to function for existing accounts, but they are no longer the recommended method for creating new tracking events.

You will encounter legacy events if you have used HubSpot for a long time, especially if you previously set up custom analytics events or tied events to older embedded tracking scripts.

Key differences from new HubSpot behavioral events

Legacy events use the original events dashboard and settings area.
They often rely on manual JavaScript snippets or older HubSpot tracking code.
Their configuration and reporting options are more limited than behavioral events.
They are mainly kept for backward compatibility and historical reporting.

Access the Legacy Events Dashboard in HubSpot

To manage existing tracking, you first need to open the legacy events tool in your HubSpot account. You must be a user with the correct reporting or admin permissions.

Sign in to your HubSpot account.
In the main navigation, go to your reporting or analytics tools, depending on your subscription.
Open the section labeled for events or legacy events. In older portals this appears as a dedicated events screen.

When you arrive at the legacy events dashboard, you will see a table listing all existing events created in the old system.

Understand the legacy events table in HubSpot

The legacy events table includes several key columns that help you assess your current configuration:

Event name: the label used across reports and filters.
Event ID: the unique identifier used in tracking scripts.
Type: indicates what the event is tracking (for example, a page view, click, or custom action).
Status: shows whether an event is currently active or no longer firing.
Created date: when the event was originally configured in HubSpot.
Recent activity: how frequently the event has been triggered in the selected time frame.

Use these fields to quickly identify which events are still relevant and which may be candidates for cleanup or replacement.

Filter and Search Legacy Events in HubSpot

Most accounts accumulate a large number of legacy events over time. Use filtering and search options to focus on the ones that matter.

Use search to find specific HubSpot events

In the events dashboard, use the search bar to locate events by name or event ID. This is useful when you are troubleshooting a specific tracking script or cleaning up similar events created by different teams.

Apply filters for faster legacy event analysis

Depending on your portal, you may be able to refine the legacy event list with filters such as:

Status: show only active or inactive events.
Type: focus on a single type of legacy event (for example, custom events).
Date range: filter based on recent activity to find events that have not fired in months.

This filtering helps you build a prioritized list of legacy events to keep, update, or remove from HubSpot.

View and Analyze Individual Legacy Events in HubSpot

Once you locate a specific event, you can open its detail view to see how it is performing and where it is used.

Open the event details panel

From the legacy events table, click the name of the event you want to analyze.
Review the summary, which typically includes type, ID, and key configuration settings.
Check the recent activity chart to see how frequently the event is triggered over the selected date range.

Use this information to determine whether the event is still relevant to your current reporting strategy in HubSpot.

Evaluate historical performance and usage

Within the event details, pay special attention to:

Total number of event completions: is this event still actively used?
Trend over time: are completions declining because your website or app changed?
Dependencies: verify whether any dashboards, custom reports, or workflows reference the legacy event.

Document any events that feed critical performance dashboards before you consider removing or replacing them in HubSpot.

Edit Legacy Events Safely in HubSpot

You may need to adjust legacy events to keep labels clear or to align them with updated reporting structures, while preserving historical data.

Update the legacy event name and description

To prevent confusion across teams, keep names and descriptions meaningful and consistent.

Open the specific event from the legacy events table.
Edit the event name to match your current naming convention.
Update the description to explain what the event tracks and where the tracking code is implemented.
Save your changes and notify reporting stakeholders of the update.

Renaming legacy events in HubSpot does not change historical records, but it makes reports much easier to understand.

Adjust configuration settings where allowed

Depending on the original setup, you may be able to modify certain configuration fields, such as:

The domain or URL pattern the event listens to.
The trigger condition, if it was constructed from predefined options.
Basic categorization settings used for reporting.

Always test changes on a staging environment or a low-traffic page when possible so your HubSpot data quality remains high.

Deactivate or Delete Legacy Events in HubSpot

Over time, websites, apps, and campaigns evolve, and many legacy events become obsolete. Clean-up keeps your analytics structure lightweight and easier to manage.

Decide whether to deactivate or delete

Before you take action, consider these options:

Deactivate: stop an event from firing going forward while preserving the configuration for reference.
Delete: permanently remove the event configuration from HubSpot; historical records may become harder to interpret if reports rely on it.

When in doubt, deactivate first and wait a reporting cycle before you permanently delete anything.

Steps to deactivate or delete a legacy event

From the legacy events table, select the event or events you want to change.
Use the bulk action menu or the individual event settings option.
Choose to deactivate or delete according to your data retention policy.
Confirm the action and document it for your analytics governance records.

After cleaning up, confirm that key dashboards and reports in HubSpot still behave as expected.

Plan Migration From Legacy to New HubSpot Behavioral Events

While legacy events continue to function, HubSpot recommends using the newer behavioral events tool for future tracking because it offers more flexibility, better integration with other features, and a more modern interface.

Map legacy events to your new tracking strategy

Use your existing inventory of legacy events as a blueprint for a modern tracking plan:

List mission-critical legacy events that power core revenue, product, or funnel reports.
Identify duplicate, low-volume, or unclear events suitable for removal.
Define how each important event should be implemented in the new behavioral events system.

This structured approach will help you upgrade your HubSpot analytics while preserving meaningful historical insight.

Create documentation and governance standards

When migrating from legacy events, document naming conventions, ownership, and review cadences so the new setup remains clean:

Standardize event names and descriptions.
Record which teams own specific behavioral events.
Schedule regular audits to retire unused events.

Strong governance prevents your new HubSpot event library from becoming cluttered again.

Where to Learn More About Legacy Events in HubSpot

For the most detailed, up-to-date technical instructions, always refer directly to the official documentation.

Official help article on analyzing and managing legacy events: HubSpot legacy events documentation.
For strategic consulting on analytics, reporting structures, and implementation, you can work with a specialist agency such as Consultevo.

By regularly reviewing, cleaning, and, when appropriate, migrating your legacy events, you ensure that your HubSpot reporting remains accurate, actionable, and aligned with your current growth strategy.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`