English (US)
  1. Zendesk help
  2. Explore
  3. Using Explore for reporting and analytics
  4. Creating dashboards

Working with the dashboard builder (Beta)

Erin O'Callaghan
  • Edited
Zendesk Documentation Team

What's my plan?

Note: This article describes the beta version of the Explore dashboard builder. For information on the classic dashboard builder instead, see Creating dashboards. For help deciding which dashboard builder to use, see Comparing features available in the dashboard builder.

The beta dashboard builder lets you create dashboards, customizable spaces for organizing and sharing information, within Explore. With it, you can quickly and easily create dashboards that give you the insights you need to optimize your service channels.

This article contains the following sections:

Creating a dashboard

You can create a dashboard using the beta dashboard builder in Explore.

To create a dashboard

  1. Click the Dashboard icon () in the left sidebar.
  2. In the banner at the top, click Try it now.
  3. In the Start a dashboard window, choose whether you want to build your dashboard from scratch (Blank dashboard) or start from a prebuilt template.
  4. Click Select.

You’re redirected to the beta dashboard builder and the new dashboard is added to the dashboards library. You can now add reports, filters, and other components, and further customize your dashboard. If you chose to start from a prebuilt template, components are already added for you (though you can always edit them or add more).

Adding and customizing dashboard components

You can add two main types of components to a dashboard: reports and filters. Reports show you metrics about your use of Zendesk either as of right now or in the past, and filters let you slice that data based on certain characteristics.

After you add a report or filter, you can customize certain things about it, including the header, size, layout, and more.

You can add up to 35 components per dashboard tab. If you have legacy tabs with more than 35 components, you can’t add more until you delete or move components to other tabs until there are fewer than 35.

This section contains the following topics:

Adding a report

  1. In the beta dashboard builder, click the plus (+) icon in the upper right.
  2. Click Live data (if you're on an Enterprise plan and want to report on near real time information) or Report (if you want to report on historical data) and select the report or reports you want to add.
    Tip: If you click Live data, you can filter by the type of component by clicking the filter icon () to the right of the search box. This makes it easier to find live data components about a specific topic.
  3. Click and drag the report wherever you want it to appear on the dashboard. The report automatically snaps to the closest line on the grid.
    Tip: To change the component's size or placement, see Resizing components and changing the dashboard layout.

Customizing the header of a report

  1. Click a report on your dashboard.
  2. In the panel on the right, use the options under the Styles heading to customize the report header:
    • Show header: Clear the check box if you don’t want the report to show its name as a header at the top of the report.
    • Background color: Select the color that appears behind the report.

Resizing components and changing the dashboard layout

By default, a dashboard’s layout automatically adjusts in the following ways:

  • The width automatically resizes to fit the viewer’s screen. The maximum size is 2k resolution, or 4k for full screen, and the minimum width is the same as the classic dashboard builder.
  • Components automatically snap to the closest line on the grid, aligning along the top edge of the dashboard.

If the default layout doesn’t work for your dashboard, you can resize individual components or change how the snap-to functionality works.

Tip: Consider creating a copy of your dashboard before resizing components or changing the layout. That way, you can experiment with changes without worrying about affecting the published dashboard.

To resize components and change the dashboard layout

  1. Open the dashboard you want to modify.
  2. In the menu bar on the right, click the Layout button () > Placement and choose from the following options:
    • Place anywhere: Freely move components wherever you’d like on the dashboard,
    • Align to top: Automatically snap components to the top of the dashboard.
    • Align to left: Automatically snap components to the left side of the dashboard.
  3. Resize individual components using the grabber in the lower-right corner of each component.

The video below demonstrates how to resize components:

Adding an alert on a live report (Enterprise only)

  1. Click a live report on your dashboard.
  2. In the panel on the right, click Alerts > Add alert.
  3. Under Alert level, choose the threshold that will trigger the alert (for example, when the report returns more than a 100 tickets).
  4. Under Background color, choose the color that the report will turn when the alert’s threshold is reached.


Customizing the tooltip on a report

  1. Click a report on your dashboard.
  2. In the panel on the right, click Tooltips.
  3. Update the text that should appear when a user hovers over the report, or turn off the tooltip completely by unchecking Show tooltip.

Allowing drill in on a live metric (Enterprise only)

Note: Drill in is available only for the following agent status live metrics: Agents online, Agents offline, Agents away, Agents invisible, Agents transfer only. For details, see Live data widgets for Explore dashboards.
  1. Click an agent status live metric on your dashboard.
  2. In the panel on the right, use the options under the Drill in heading to configure how much detail dashboard viewers can see when they drill in on the live data metric. For more information, see Seeing live agent status and activities.
      • Agent statuses: Allows the viewer to see the list of agents in each status.
      • Work items: Allows the viewer to see an individual agent’s tickets, chats, and conversations.

Adding a filter

  1. Click the plus (+) icon.
  2. Click one of the following, and then select the filter or filters you want to add:
    • Live filter: (Enterprise only) Filters live data by ticket brand or group. When somebody views your dashboard, they can select up to five values to restrict the results by.
      Note: Don’t add multiple copies of the same live filter. If you do, dashboard viewers can select up to five values in each (for a total number greater than five across all copies of the filter), but the report results will not be accurate.
    • Time filter: Filters historical data by a specified time period. When somebody views your dashboard, a default value of 30 days is applied, but the viewer can change the time range as needed.
    • Data filter: Filters historical data by the specified attributes. When somebody views your dashboard, they can select an unlimited number of values to restrict the results by.
  3. Click and drag the filter wherever you want it to appear on the dashboard. The filter automatically snaps to the closest line on the grid.
    Tip: To change the component's size or placement, see Resizing components and changing the dashboard layout.

Adding a text component

Text components let you add additional context to your dashboard, like descriptions of the reports or section headers.

  1. In the beta dashboard builder, click the plus (+) icon in the upper right.
  2. Under Other components, click Text.
  3. Click the component that appears on your dashboard and type in your text.
  4. Use the formatting tools underneath the component to format your text, including styles, colors, links, and more.

Renaming a report or filter

  1. Click a report or filter on your dashboard.
  2. In the panel on the right, click the options menu icon next to the component's name.
  3. Click Rename.
  4. Enter a new name for the component and click the checkmark.

Removing a report or filter

  1. Click a report or filter on your dashboard.
  2. In the panel on the right, click the options menu icon next to the component's name.
  3. Click Remove > Remove item.

Adding tabs to a dashboard

If your dashboard contains a lot of information, you might want to separate this information into different tabs to improve the dashboard’s usability.

The Tabs pane appears to the left of your dashboard. From here, you can add and manage tabs for your dashboard.

By default, a dashboard has no tabs. A dashboard must have at least two tabs for anything to appear in the Tabs pane.

To add a tab

  • In the Tabs pane, click the plus (+) icon.

A new tab appears in the list. Newly created tabs are named New tab by default and are always empty.

When you add a tab to a dashboard for the first time, two tabs (not just one) appear in the Tabs pane. This is because any existing dashboard contents are preserved as the first tab, and a blank dashboard is created as the second tab.

Note: You can create up to ten tabs per dashboard.

To rename a tab

  1. In the Tabs pane, hover over the tab you want to rename.
  2. Click the options () icon and click Rename.
  3. Give the tab a descriptive name, and click the checkmark to save it.

To reorder tabs

  • Click a tab and drag it lower or higher in the list to change the order of the tabs.

To delete a tab

  1. In the Tabs pane, hover over the tab you want to delete.
  2. Click the options () icon and click Delete.

If you delete all dashboard tabs except for one, the last remaining tab is no longer considered a tab and doesn’t appear in the Tabs pane. Instead, the contents of the last remaining tab become the only contents of the dashboard.

To hide or show tabs

  1. Click the arrow in the top-right of the Tabs pane to hide the list of tabs.
  2. Click the arrow again to show the pane.

Toggling drill in on a dashboard

The drill in feature lets dashboard viewers refine the results of a report by slicing its metrics by additional attributes. For details, see Using drill in to refine your reports.

By default, drill in is allowed on any dashboard built with the beta dashboard builder.

To toggle drill in on a dashboard

  1. In the beta dashboard builder, click the settings icon ().
  2. Select or clear the Allow drill-in checkbox, depending on whether you want dashboard viewers to be able to refine a report’s results.

Editing a dashboard

You can edit a dashboard you’ve already created using the beta dashboard builder.

To edit a dashboard

  1. Click the Dashboards library icon () in the left sidebar.
  2. Hover over the dashboard you want to edit and click Edit.
  3. Add, customize, and remove components as needed.
Tip: Use the Undo () and Redo () buttons to quickly adjust any edits you make. Note that these actions work across tabs. If your dashboard has multiple tabs, changes that you undo or redo might be on a tab other than the one you’re viewing.

Previewing a dashboard

You can preview a dashboard to see how it will look from an end user’s perspective.

To preview a dashboard

  1. In the beta dashboard builder, click the View button in the upper left.

Sharing a dashboard

When you create a dashboard in Explore, by default only you can see it. To share your dashboard with others, you need to invite them.

To share a dashboard with other agents

  1. Open the Invite people menu using one of the following methods:
    • From an open dashboard: Click the Share button.
    • From the dashboards library: Click Share from the options menu drop-down to the right of your dashboard’s name.
    The Invite people menu opens.
  2. In the Add team members or groups field, search for and select the agent or group you want to share with. If you’re not sure which users are in a group, hover over View info to see up to 20 members of the group, organized alphabetically.
  3. In the Access field, decide whether you want to restrict the dashboard’s data for the users you’re inviting. See Dynamically adapting dashboard data based on viewer.
  4. (Optional) Clear the Send email notification checkbox if you don’t want to send an email notification to the invited users to view the dashboard. If you don’t send an email, users can still find the dashboard in the report library or by going to the dashboard’s URL.
  5. Click Invite people.

Sharing a dashboard externally (Enterprise only)

If you’ve enabled external link sharing, you can share dashboard links with people outside of your Zendesk account.

This section contains the following topics:

Generating an external dashboard link

  1. Create a new dashboard or open an existing dashboard.
  2. Click the drop-down arrow next to Share and select Get a link.

    The Create link window opens.
  3. In the Access type field, select whether viewers of the dashboard link should be able to see All data, or only the data included in a specified dashboard restriction.
    Note: Dashboard restrictions that use the Based on viewer setting can’t be shared externally and don’t appear in this list.
    Tip: Click Create dashboard restriction in the drop-down to easily create a new dashboard restriction. See Dynamically adapting dashboard data based on viewer.
  4. (Optional) Deselect Protect with password so viewers don’t need to enter a password to open the dashboard.
  5. (Optional) Enter a new password to replace the randomly generated password. You can click the eye icon to view the password in plain text. Passwords must meet the following criteria:
    • At least 10 characters
    • 1 uppercase letter
    • 1 symbol
    • 1 number
  6. (Optional) Click Copy password to copy it to the clipboard. Save this password in your password manager, as it can’t be displayed again. However, you can reset the password later, if necessary.
    Note: If a user attempts to access a password-protected dashboard and enters an incorrect password five times, the dashboard becomes inaccessible for all users for five minutes.
  7. Click Create link.
  8. Click the drop-down arrow next to Share and select Get a link again.
  9. Click Copy link to copy the external dashboard link to the clipboard.
  10. Share the link (and password, if applicable) with anyone who needs to view the dashboard.

Resetting the password on an external dashboard link

  1. Open a dashboard that you’ve already generated an external link for.
  2. Click the drop-down arrow next to Share and select Get a link.
  3. In the Get link window, click the options () icon and select Reset password.

The previous password will no longer work for accessing the dashboard via the external link.

Removing the password on an external dashboard link

  1. Open a dashboard that you’ve already generated an external link for.
  2. Click the drop-down arrow next to Share and select Get a link.
  3. In the Get link window, click the options () icon and select Remove password.

Anyone with the link can now view the dashboard without entering a password. If necessary, you can reset the password to add one back.

Deleting an external dashboard link

  1. Open a dashboard that you’ve already generated an external link for.
  2. Click the drop-down arrow next to Share and select Get a link.
  3. In the Get link window, click the options () icon and select Delete link.

The previously generated link will no longer work for accessing the dashboard. If necessary, you can generate a new link.

Exporting dashboard content

Sometimes, you might want to save the current version of a dashboard tab or report. Or, you might want to view the data in a different format. You can save individual dashboard tabs or reports to your computer using the Export option.

This section contains the following topics:

Exporting a dashboard tab

You can export an entire tab from the dashboard builder. When exporting tabs, you must export them one at a time. It's not possible to export all of a dashboard's tabs at once.

To export a dashboard tab

  1. With a dashboard open, select the tab you want to export.
  2. (Optional) Next to the dashboard’s name in the upper-left, select the dashboard restriction you want to export. If you want to export all data from the tab, make sure All access is selected.
  3. Click the export icon in the top-right corner of the dashboard.
  4. In the Export dashboard window, select an export format of CSV, Excel, Image, or PDF. See Choosing an export format for more details about each option.
  5. Click Export dashboard.

Exporting drill in results

You can export the contents of a drill in window.

To export drill in results

  1. With a dashboard open, drill into a report.
  2. Click the drop-down arrow next to Export and select an export format of Excel or CSV.
  3. Click Export.

Cloning a dashboard

When you need a dashboard that’s similar to an existing dashboard, you can clone the existing dashboard and tweak it from there. Cloning dashboards is faster than recreating them from scratch.

To clone a dashboard

  1. Click the Dashboards library icon () in the left sidebar.
  2. Hover over the dashboard you want to clone and click the settings drop-down to the right of your dashboard’s name.
  3. Click Clone.
  4. In the Clone dashboard menu, choose a new name for the cloned dashboard, and decide whether you want to clone the reports as well as the datasets.
  5. Click Clone.
Tip: If you’re planning to simply add new reports to a dashboard, there’s no need to clone the reports or datasets. However, if you want to customize the reports for the cloned dashboard in a different way than the original, you must clone the reports. Cloning the dataset is rarely needed. It’s useful only if you want to separate the cloned reports in a different dataset.

Deleting a dashboard

If you no longer need a dashboard, you can delete it. This keeps your dashboards library cleaner and makes it easier to find the dashboards you do need.

To delete a dashboard

  1. Click the Dashboards library icon () in the left sidebar.
  2. Hover over the dashboard you want to delete and click the settings drop-down to the right of your dashboard’s name.
  3. Click Delete.
  4. In the Delete dashboard menu, click Yes, delete.
Return to top

57 Comments

  • Agnieszka Czajka
    Zendesk Product Manager

    Sam at the moment unfortunately there is no possibility to export reports in the new dashboard builder but we are working on it at the moment so stay tooned and follow these post to get updates on the release. 

    0
  • Mistyamber Reynolds

    Is it possible to add tabs to the new dashboard builder?

    0
  • Pete Holborow

    Finding this tool very useful for spinning up quick dashboards. I'm struggling to share with some light agents on the team though, they are listed as having access but cannot view the dashboard.

    Is sharing enabled for light agents in this beta version? I have checked that they have the correct permissions and they can view other dashboards.

    0
  • Tina Yates

    For some reason I cannot save my text box text.  What am I missing?  Anyone else experiencing the same issue?

    0
  • Jack Petersen

    Why do we no longer have the ability to export data on the beta version of Explore? It is a very basic aspect of the existing Explore instance but doesn't seem possible on new dashboards. This is highly disruptive as we often have to export to Excel to put together data in the way we need. 

    0
  • Walter Bellante
    Zendesk Product Manager

    Hello,
    thanks for your feedback and questions about the beta dashboard builder.

    Mistyamber Reynolds it will be possible to add tabs before the GA. You can learn more about the upcoming features here

    Pete Holborow thanks for your positive feedback. I would recommend opening a ticket so we can look into it.

    Jack Petersen the ability to export data will be available before the GA of the beta builder.

    0
  • Jen C

    Finally diving into this, is there a way to assign the filters to the reports. I added a time filter and I can't find a way to make all the reports adjust to the time filter like in our current dashboard. Is there a way to assign the time and data filters to the reports on the dashboard? 

    Also, I added a data filter and wanted to exclude something from my report. Is there a way to do that from the data filter? Or do I need to only exclude it in the report?

    Thanks! I've got a lot to convert over to this new dashboard.

    0
  • Walter Bellante
    • Edited
    Zendesk Product Manager

    Hi Jen C,
    thanks for trying the beta builder.

    As for the time filters, is it possible that the reports are linked to different datasets and the time filter doesn't belong to the same dataset?

    The ability to link filters across datasets and to exclude filters from specific reports will come before the GA of the beta builder.

    Here you can learn more about the upcoming features.

    I hope it helps.

    Regards,
    Walter

    1
  • Jen C

    Thank you @Walter Bellante! Also, with the change from the current dashboards to the new Beta dashboards, will all our Reports and Datasets stay the same? Meaning, can I just pull in all my existing reports into the new Beta Dashboards and essentially all I'm doing is adjusting the layout and dashboard filters rather than recreating all my current reports? 

    Also, our dashboards have a lot of tabs. Will we be able to have tabs in this beta dashboard or essentially each tab is its own dashboard? Thats fine, just wanted to make sure I'm not missing anything. Thanks! 

    0
  • Walter Bellante
    Zendesk Product Manager

    Hi Jen C,

    Meaning, can I just pull in all my existing reports into the new Beta Dashboards and essentially all I'm doing is adjusting the layout and dashboard filters rather than recreating all my current reports? 

    Yes, that's correct. All your existing reports can be plugged to the dashboards built with the beta builder.

    Will we be able to have tabs in this beta dashboard or essentially each tab is its own dashboard?

    Yes, you will. Tabs will be available before the GA of the beta builder.

    Regards,
    Walter

     

    0
  • Tim Nagel

    It is currently not possible to export the content of a "Drill-In" 
    This option IS however possible in the old dashboards. 

    Without being able to export drill-in data, it seems kind of useless to me. I would highly appreciate if this option can be enabled the same way it is possible for the old dashboards.


    1
  • Andrew Chu

    I'm having similar issues with creating and saving alerts like what was described earlier in Denise's comment on July 18. Please check and revert back asap

    0
  • Mike dela Rosa
    Zendesk Customer Care
    Hi Tim!

    We have noted your feedback and will update our Beta users for additional features in the near future!
    0
  • Ashley Moore

    Drill in function does not seem to work even with it enabled? 

    No ability to select all in filters or exclude option?

    No bookmark option?

    Time filter, rather than having separate ones for created, solved etc, can we not have an all, so for a whole set date range, all ticket actions.

    0
  • Cheeny Aban
    Zendesk Customer Care
    Hi Ashley, 

    We can see that a ticket is already created on behalf of your account. Rest assured that our Engineers will do their best to help you with your concern!
    0
  • Stephen

    HI,

    Having spent some more time with the beta builder, I have found 3 issues:

    • Drill-In is not working even when enabled on the Dashboard.
    • Text element issues - #1) after typing text in a text box and formatting it, moving the box will remove all text from the box and it needs to be updated again. #2) publishing a Dashboard, closing it and re-opening it removes all the text from the text boxes.
    • Dashboard restrictions do not have an option to set Live filters.

     

    0
  • Tina Yates

    Hi,

    I had the same issue as Stephen  with regards to the text box issue and was advised to use Google Chrome.  I think Zendesk needs to be compatible with more than one browser as it is an international application and needs to be more accommodating.

    1
  • Stephen

    Hi,

    Seeing Tina's comment is disappointing - I use Firefox and have noticed some strange occurences in Zendesk, but nothing as frustrating as the text issue. I have logged a ticket with Zendesk in relation to this.

    The other thing I would like to mention - the Alerts seem like an interesting feature, but is fairly limited.

    • It would be interesting if you could set multiple Alerts for a single report (ex. Open tickets >10 = yellow, >20 = red). At the moment, the Alerts feel very binary.
    • To go a layer deeper with that, it would be amazing to send an alert to Slack and / or via Email, if an Alert triggers with a link directly to the Dashboard.

    In general, live data doesn't feel very robust yet. I posted feedback on another thread on that topic: https://support.zendesk.com/hc/en-us/articles/4408843771546?page=2#comment_6283245757082

    0
  • Agnieszka Czajka
    • Edited
    Zendesk Product Manager

    Hi Jen C! Tabs are now available in Beta Dashboard builder. Looking forward to your feedback.  

    0
  • Agnieszka Czajka
    Zendesk Product Manager

    Hi Mistyamber Reynolds, 

    Is it possible to add tabs to the new dashboard builder?

    Yes! You can now add tabs in the Beta Dashboard Builder. You can read more on how to do it in these article. 

    0
  • Agnieszka Czajka
    Zendesk Product Manager

    Hi Harper Dane!

    You can now add tabs in Beta Dashboard Builder. Looking forward to any feedback you may have. 

    0
  • Viachaslau Skorbezh

    Hi Agnieszka Czajka

    When will Drill-In be available not only for agent statuses? When will Decompose be available? The main reason why we use dashboard builder (Beta) only for online statistics is that it is not possible to decompose the data (let’s say by ticket ID).

    0
  • Tina Yates
    • Edited

    Testing the export function as a pdf and while it is exporting it is not exporting the entire dashboard, it is cutting off part of the bottom, it appears it only exports what is visible and not the entire page.  This is a huge issue for me.  Exporting needs to work like it currently does and it isn't.

    0
  • Enzo BEAUCHAMP

    Hello, I recently used this new dashboard builder and I faced a problem while I was adding existing widgets to my new dashboard.

    Some of the widgets were not loading and showing "Failed to load widget content". I got in touch with the support in order to find a solution but it seems like it's a problem on your side.

    The solution was to go into the widget details one by one and save them. After that, the widget was working as expected in my new dashboard.

    It could be great if you can handle this case, thanks.

    0
  • Jahn Bronilla
    Community Moderator

    Hello Erin O'Callaghan,

    Feedback that could be useful and apologies if this has been advised already in the thread. In the Classic Builder you can actually select what's on your date filter eg., Works on all Created Date, Updated Date, Solved Date.

    With the new beta builder you need to actually add 2 date filter in a Tab which I don't think is a good a idea. 

    Do we have plan to implement same Date Filtering in the new Beta Builder?

    0
  • Walter Bellante
    Zendesk Product Manager

    Hello Jahn Bronilla,
    the ability to have filters working across datasets (Link filters) will come in the new dashboard builder in the first half of '24.

    You can learn more about all the upcoming features here.

    Regards,
    Walter


    0
  • Jahn Bronilla
    Community Moderator

    Hey Walter Bellante, it's perfect! Thanks for the update mate

    0

Please sign in to leave a comment.

Related articles

Powered by Zendesk