Create a custom report

Report on exactly the conversation or ticket data that’s important to your business.

Beth-Ann Sher avatar
Written by Beth-Ann Sher
Updated this week

You’ll find all reporting for your workspace under Reports. Any custom reports that you create personally, are listed in the sidebar under My reports.

Create a report

To create a new custom report, click the + icon

Add a chart

Give your report a clear title and description so your teammates can see at a glance what it’s for. Then add your first chart from a template, or by clicking + Add chart.

Choose a metric

Each chart supports one metric per timestamp (the date range you’ve selected).

See all definitions for conversation and ticket metrics, date filter timestamps and attributes in Intercom reports.

If you choose a relative date range like ‘Past 4 weeks’ the chart will always show you the past 4 weeks. If you choose specific dates like ‘1st - 31st of Jan’, it will always show data from those specific dates.

Metrics can be aggregated by average, median, minimum, or maximum:

Note:

Choose a chart type

There are four ways to visualize your data to choose from: count, column, line, or table:

Count

Counts are the perfect way to get a quick summary without the need for a detailed breakdown:

Column

With a simple column chart, you can break down the data by conversation data attributes, user data or other metrics & properties in Intercom.

You can also define exactly how many of the top groups to show.

With a column chart, segmenting the data lets you visualize it in two dimensions. In this example you can see the columns are grouped by month, and segmented by the“Ticket type”:

Optionally, you can also stack a column chart with the “Stacked” toggle below the chart type.

Columns within a grouped column chart do not “group” when a value from the “Segment by” is empty on some days.

Line

Line charts offer the same options to view and segment your data, but are better suited to showing trends over time.

For example, you can see the same data here. It's segmented on the left, and stacked on the right:

When using the “Line” chart type, if selecting 'view by: time' with a single point, the line series on the charts will appear as a single dot. You will need to select a smaller time granularity to see change over more than one breakdown.

Table

A table gives you a sortable list of values broken down by the dimensions you choose, for example this shows the average CSAT score for each team, segmented by channel:

Conversation drawer

Each chart has a conversation button on it, which opens a conversation side drawer when clicked. This side drawer lets you see the most recent 100 conversations which match the chart.

Add filters

Finally, add any filters you’d like for a more zoomed-in view of your data. For example, you might build a custom report for a certain region, in which case you’d filter for the relevant continent or country:

This supports both AND and OR conditions when selecting multiple filters, which is available at both a chart and custom report level. For example, this chart is filtered by conversations which have:

  • Topic = “pricing” OR

  • Tag = “pricing”

While you can use AND conditions and OR conditions with filters, you can't use both AND/OR conditions at the same time.

Important: Intercom takes a snapshot of the customer when the conversation starts which means that any changes to user and company attributes after the conversation is created are not reflected in the reports.

Additionally, some metrics (those that are calculated at the time vs. a static value, like Customer satisfaction, for example) will display an error when the selected break down has more than 10,000 unique values for the range/filters.

Company Attributes Filters in Custom Reporting

You can choose a company attribute as a filter in a custom report at the report level, or at an individual chart level. Note that if you do both, the report level filter takes precedence.

The company attribute filter allows you to only filter by company attributes but does not allow you them to group by them. Filtering means including or excluding certain information and filtering occurs in the filters dropdown at the top left of the custom report page. Grouping, however, is organizing a report in a way that makes sense for the viewer and occurs at the chart level.

And that’s it. 👌 Just click save and close to save this chart to your custom report.

You’ll see the chart added to the report, where you can continue adding more charts.

There is no limit to the number of charts in a report.

Set timezone

Charts are based on the workspace timezone by default, and comply with the workspace’s setting to include or exclude Office Hours from reporting (which is set in Messenger Settings).

To change the timezone for a custom report, you'll need to finishing adding charts and save it, then change the timezone at the top of the report page.

Click Save report for the timezone setting to persist when you exit and view the report again.

Setting a timezone is unavailable on pre-built Intercom reports and can only be used on custom reports.

Relationship between report filters and charts

You can add filters to Reports and add filters to Charts. When you add a filter to a Report, this also applies to the Charts within the Report. If you add a date filter to the Report, this will override the Chart’s date filter.

If your Chart had a date range of 'today' defined, but you set the report date range to yesterday, you’ll then see the Chart update to show yesterday.

When you click into the chart’s view to edit, the report filter will not override what you see there. The report filter affects what you see on the charts when viewing the report. If you add any other filter to the report, this will augment the chart’s filter. This means that the Chart will be treated as if it had an additional filter (this is treated as a Match all/and situation). So, if the chart had a filter of “Teammate participated is Beth” and you then added a filter on the report,“Teammate participated is Kendall,” the chart would then only show data for conversations that both Beth and Kendall participated in.


Viewing, filtering and sharing reports

When viewing your report you can easily add more filters which will apply in addition to existing filters that are set within the charts.

For example, the chart in this report filters for data from Europe, and we’ve applied a filter at the report level for ‘Channel is Chat’. This means the chart is now showing data from conversations started in Europe via Chat:

To share your report with these filters applied, just click ‘Save report’, and copy the page URL for any of your teammates.

Note:

  • The ‘Channel’ filter will only contain those channels where you have installed Intercom.

  • If you add a ‘Date range’ filter at the report level, this will override the existing date ranges set in your individual charts, while the filter is active.

  • Custom events are currently not supported for filtering custom reports.


Editing, duplicating, or deleting charts

To edit or delete an existing chart from your custom report, hover over it and select an option from the Actions dropdown.


Seeing unexpected results?

If you’re unsure of the data in your reports, check out this article for a close look at some of the details.


💡Tip

Need more help? Get support from our Community Forum
Find answers and get help from Intercom Support and Community Experts


Did this answer your question?