Customize Zendesk Chat widgets

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

February 20, 2025

Table of contents

• Account
• Metric
• Visualization picker
• Grouping
• Split by
• Time
• Compare to previous period
• Min/Max values
• Filter results
• Set a goal
• Formatting

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

Account

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

Metric

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 depend on how you've configured your widget. See our guide to choosing the right visualization for your data.

Grouping

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.

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

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.

Time

The time picker allows you to select a 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.

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.

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.

Formatting

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.