How to | Build Registrant Based Reports
Learn how to build powerful HubSpot reports using the hapily Registrants object — including daily registrant tracking, lifecycle stage breakdowns, and traffic source analysis — with step-by-step visual guides.
You can breakdown registrant, event, and session data in many different ways in HubSpot when using hapily.
Here are the 3 most common report types that our customers as for. Feel free to follow along with the guides and put your own spin on their basic structure.
- Event Registrations created over time (Days, Months, etc...)
- Event Registrations broken down by Lifecycle Stage (Lead, Customer, etc...)
- Event Registrations broken down by Traffic Source (Original, Latest, etc...)
📊 How to Create a Report Showing Registrants Created by Day in HubSpot
This guide walks you through creating a custom report in HubSpot that visualizes how many registrants were created each day using the hapily Registrants object.
Step 1: Open the Reporting Tool
-
In HubSpot, navigate to Reporting from the main navigation bar.
-
Click Reports to open the Reports tool.
Step 2: Create a New Custom Report
-
Click Create report.
-
Select Custom report and click Next.
Step 3: Choose Your Data Source
-
In the data source selection screen, choose hapily Registrants as the primary data source.
-
Why? Because the “Create Date” on the Registrants object represents the exact moment someone registers.
-
Using this object ensures the report counts when each registration occurred, rather than relying on contact data.
-
-
Click Next to continue.
Step 4: Configure the Chart Type
-
For your visualization, select the Vertical Bar Chart.
-
This format makes it easy to see the number of registrants per day at a glance.
-
Step 5: Define the Y-Axis (Count of Registrants)
-
In the configuration panel, set the Y-Axis to Count of hapily Registrants.
-
This will represent the total number of registrants for each date.
-
Step 6: Define the X-Axis (Create Date)
-
Locate the Create Date or Create Date & Time property.
-
If you don’t see it right away, use the search bar to find it.
-
-
Drag Create Date & Time to the X-Axis field.
-
This will group registrants by the date they were created.
-
Step 7: Review Your Chart
-
Once you’ve added both axes, the chart should now display bars representing the number of registrants created on each day.
-
You can hover over each bar to see the exact count.
✅ You now have a report showing daily registrant creation trends.
🎯 How to Create a Report Showing Registrants Broken Down by Lifecycle Stage in HubSpot
This guide walks you through creating a custom report that breaks down your hapily Registrants by their associated Contact Lifecycle Stage — giving you insight into what stage your event registrants are in within the customer journey.
Step 1: Open the Reporting Tool
-
In HubSpot, click Reporting in the left-hand navigation.
-
Select Reports to open the Reports tool.
Step 2: Create a Custom Report
-
Click Create report.
-
Choose Custom report and click Next.
Step 3: Select Your Data Sources
-
For the Primary data source, choose hapily Registrants.
-
This ensures the report centers on each registration record.
-
-
Add a Secondary data source by clicking Add data source → choose Contacts.
-
Why? Because Lifecycle Stage is a Contact property, not a Registrant property.
-
Adding Contacts ensures each registrant’s associated contact record (and its properties) are available for reporting.
-
-
Click Next to continue.
Step 4: Choose the Chart Type
-
Select Pie Chart as your visualization.
-
(You can also use a vertical bar chart if you prefer, but pie charts are ideal for category breakdowns.)
-
Step 5: Define Your Metric (Values)
-
In the Values field, drag in Count of hapily Registrants.
-
This will measure how many registrants fall into each lifecycle stage.
-
Step 6: Break Down by Lifecycle Stage
-
In the left-hand property selector, switch from hapily Registrant properties to Contact properties.
-
Search for Lifecycle Stage.
-
Drag Lifecycle Stage into the Break Down By field.
-
This will categorize your registrants by the current lifecycle stage of their associated contact record.
-
Step 7: Review Your Report
-
The chart will now display the proportion (or count) of registrants within each Lifecycle Stage (e.g. Subscriber, Lead, Marketing Qualified Lead, Customer, etc.).
-
Hover over each section to see totals or percentages.
Optional: Create a Snapshot Property (Advanced)
If you want to capture a registrant’s lifecycle stage at the time they registered, rather than their current one:
-
Create a custom Registrant property called “Lifecycle Stage (at Registration)”.
-
Use a workflow to copy the value of the associated Contact’s Lifecycle Stage into that property at the moment of registration.
This gives you historical accuracy if contacts move stages later.
✅ You now have a report showing the lifecycle stage distribution of your registrants!
🌐 How to Create a Report Showing Registrants Broken Down by Traffic Source in HubSpot
This guide explains how to build a custom HubSpot report that shows where your event registrants are coming from, based on their associated contact’s traffic source. This helps you understand which channels drive the most registrations.
Step 1: Open the Reporting Tool
-
In HubSpot, click Reporting on the left-hand menu.
-
Select Reports to open the reporting dashboard.
-
Click Create Report to start a new one.
Step 2: Choose a Custom Report
-
Select Custom Report.
-
Click Next on the top-right corner.
-
Choose to build the report from scratch.
Step 3: Select Your Data Sources
-
Set hapily Registrants as your primary data source.
-
This ensures the report focuses on registrant records.
-
-
Add Contacts as a secondary data source.
-
Why? Because traffic data lives on contact records (in contact properties), not on the registrant object.
-
Making Contacts secondary ensures you only pull contacts that are associated with registrants — not every contact in your database.
-
-
Click Next.
Step 4: Choose the Chart Type
-
You can visualize this in a few ways:
-
Vertical Bar Chart – best for simple comparisons
-
Pie or Donut Chart – great for share breakdowns
-
KPI or Summary Chart – for quick totals
-
-
For this example, select Vertical Bar Chart (you can switch later).
Step 5: Define Your Metric (Values)
-
Under Values, add Count of hapily Registrants.
-
This will show the total number of registrants per traffic source.
-
Step 6: Break Down by Traffic Source
-
Switch from hapily Registrant Properties to Contact Properties in the left panel.
-
Search for Traffic to find relevant properties.
-
You’ll see options such as:
-
Original Source → the channel where the contact was first created (e.g., organic search, social, email, offline).
-
Latest Source → the most recent channel the contact engaged through.
-
-
-
Drag Original Traffic Source (or Latest, depending on your goal) into the Group By field.
Step 7: Review and Customize
-
You’ll now see your registrants grouped by their contacts’ traffic sources.
Common values include:-
Organic Search
-
Email Marketing
-
Social Media
-
Paid Search
-
Direct Traffic
-
Offline Sources
-
-
You can also experiment with:
-
Traffic Source Drill-Down 1 for deeper breakdowns (e.g., specific URLs or campaigns).
-
Pie Chart View for a visual share of sources.
-
KPI View for headline counts.
-
Step 8: Optional — Capture a “Snapshot” of Traffic Source
If you want to preserve what the traffic source was at the time of registration:
-
Create a custom Traffic Source (at Registration) property on the Registrant object.
-
Build a workflow that copies the Contact’s Original or Latest Traffic Source into that property when a registrant is created.
-
Report directly on that registrant-level property for historical accuracy.
Step 9: Finalize Your Report
-
Adjust filters or visualization as desired.
-
Save and name your report (e.g., “Registrants by Traffic Source”).
-
Add it to a dashboard for ongoing tracking.
✅ You now have a report showing where your registrants come from, based on traffic source data!