Customize Zendesk Chat widgets

Learn how to adjust presentation options and filter your Zendesk Chat data to create easy-to-understand visualizations.

Updated over a week ago

This is a Pro data source. If not available on your plan please upgrade or contact our support team.

This guide walks you through the various options available when customizing Zendesk Chat widgets.

Widget config for Zendesk Chat


If your plan allows, you can connect to multiple Zendesk accounts. To do this, open the Connection menu and click Add connection.


The metric picker allows you to select any of the Zendesk Chat metrics Geckoboard supports.

Line charts, Column charts and Tables allow plotting a second metric on the same widget. To do this, click Add second metric.

Visualization picker

The visualization picker allows you to choose between plotting your data as:

  • Number

  • Line chart

  • Column chart

  • Bar chart

  • Leaderboard

  • Table

The options available depends on how you've configured your widget. See our guide to choosing the right visualization for your data.


If you want to group by a certain dimension you need to select a visualization that supports grouping:

  • Column chart (under Horizontal Axis)

  • Bar chart (Labels)

  • Leaderboard (Labels)

  • Table (Group by)

For example, you could try the Leaderboard visualization configured to show Average chat duration by Agent.

Grouped leaderboard widget showing Zendesk chat data

Or, you could show Chats by Agent as a bar chart.

Grouped bar chart widget showing Zendesk chat data

Split by

If you're creating a Line or Column chart and haven't chosen additional metrics to compare, you can Split by a chosen dimension.

For example, you could try splitting Chat volume by Department.

example of a line chart showing Zendesk Chat data split over the same chart in Geckoboard


The time picker allows you to select timeframe for your data. You can also create a Custom period from the bottom of the select menu.

Compare to previous period

If you're creating a Number or Line chart, you can compare to a previous period.

For example, you could try comparing Today to the Same day last week.

Comparing today's data to the same day last week

Min/Max values

The Gauge visualization supports setting minimum and maximum values. If left blank, these values are automatically calculated.

Filter results

Filters allow you to dial in to the exact value you care about. Filter options available include:

  • Is: show only those values that the data is

  • Is not: show only those values that the data is not

For example, you could use filters to show your Agents currently online by Department.

examples of using group of number widgets to show Zendesk Chat agent activity in Geckoboard

Set a goal

On the Number, Line, Column and Bar charts visualizations it's possible to show your progress towards a chosen target by setting a goal.

Setting a Starting from value on Number visualizations enables you to set more meaningful goals.


The Formatting menu allows you to overrule the automatically set number of decimal places used, or add additional information about the values on your widget. For more information, see our guide to using the data formatting options.

Did this answer your question?