Single-object reports
The simplest custom report analyses one object type. You pick the object (contacts, companies, deals, or tickets), choose which properties to report on, add filters, and select a visualisation.
Go to Reporting and Data > Dashboards > Add Report > Create Report > Single Object. Select your object (e.g. Contacts). HubSpot shows a builder with three tabs: Data, Filters, and Visualisation.
Data tab. Add the properties you want to analyse. For example: lifecycle stage, industry, create date, original source.
Filters tab. Narrow the dataset. The default filter is usually "Create date is this quarter". Change it to match your question. Add filters for specific lifecycle stages, regions, industries, or any other property.
Visualisation tab. Drag your categorical property (e.g. industry) into the axis box and your metric (e.g. contact count) into the value box. Choose a chart type: bar, pie, donut, table.
Example: "Contacts by industry, created this year" uses contacts as the object, industry as the category, contact count as the metric, and create date filtered to "this year".
Multi-object reports (custom report builder)
When you need to combine data from multiple objects, use the custom report builder. This lets you report on, say, companies with associated deals, or contacts who are linked to specific deal stages.
The process follows five steps: select data sources (which objects), choose properties from each object, add filters, set the visualisation, and save.
Go to Reporting and Data > Create Report > Custom Report Builder. Select your primary and secondary data sources. The builder shows which objects can be combined based on HubSpot's association model (contacts are associated with companies, companies with deals, etc.).
Multi-object reports are powerful but more complex. Start with single-object reports for your first few custom builds.
The planning step most people skip
Before opening the report builder, sketch out what you want the final report to look like. What's on the X axis? What's on the Y axis? What filters apply? What chart type tells the story?
This takes two minutes on paper and saves twenty minutes of clicking around in the builder. The custom report builder has a lot of options, and it's easy to get lost if you don't have a clear destination.