All docs

Dashboards and charts

Build dashboards of numbers, charts, funnels and tables over your records, filter them by date, share them with your workspace and show a chart on a record page.

Updated . 5 min read.

A dashboard is a page of charts over your records: how many deals are open, what they are worth, where they sit in the pipeline, how many records were added each month. Open CRM, Dashboards to see the ones you can use, or to make your own.

What a dashboard holds

Each chart is a widget that you place on a 12-column grid.

Widget Shows
Number One figure: a count, a total, an average, the lowest or highest value, how many records have no value in a field, or what share of them have none
Bar A figure for each group (a stage, an owner, a client, a month), with up to eight series side by side
Line and area A figure over time, by day, week, month, quarter or year, with no gaps between the dates
Pie and donut How a whole splits between groups
Funnel How many records sit in each step, in the order of the options, such as the stages of a pipeline
Table The first records by a sort you choose, with the fields you pick
Goal A figure against a target, with the share reached

Every widget counts the records of one object and can be narrowed with the same filter builder as a saved view. The groups past the number you ask for are added up as Other. A date field on the axis puts records without a date nowhere, so they are not drawn.

Building one

  1. Choose New dashboard, give it a name and decide who sees it: Only me or Everyone in the workspace.
  2. Choose Add widget, pick a kind, an object and what to measure, and watch the preview change.
  3. Drag a widget by its title to move it and its corner to resize it. With the keyboard, focus a widget and use the arrow keys to move it, and hold Shift with the arrow keys to resize it.
  4. Choose Done. Every save is kept as a version (the last 20), so you can go back.

To go back, open Version history on the dashboard (owners and administrators), see who saved each version and when, and choose Put back on the one you want. It becomes the newest version, so the one you leave stays in the list. Charts over fields that were deleted since are left out.

Choose Make a copy on any dashboard you can open to get a private copy of your own, with the same charts and date range. Share it afterwards if others should see it. A copy counts against the number of dashboards your plan allows.

The Date range above the widgets narrows every chart at once. It applies to the date field each widget names, or to the date the record was created.

On a phone the widgets stack in one column, in reading order.

Who sees what

A private dashboard belongs to you alone. A shared one is visible to every member, but the numbers on it are worked out for the person looking, from the records they may read. Someone who cannot read an object sees a note instead of a chart, and a chart that uses a field their role hides is left blank too. They never see a count they could not see on the object's own page. Row rules apply: a person who is limited to their own records sees totals of their own records.

You can change or delete a dashboard you made. Owners and administrators can also change and delete the shared ones. Sharing a dashboard with the workspace needs a role that can change records.

Money

Amounts in different currencies are never added together. A total, average, lowest or highest value of a money field is shown per currency: one figure, or one series, for each currency that occurs. To show one currency only, choose it in the widget. A goal over money always counts a single currency.

How fresh the numbers are

Numbers are kept for about a minute and refreshed as soon as a record, a link between records, a permission or the data model changes. The dashboard reloads on its own every few minutes while it is open.

A chart on a record page

In the layout editor of an object, add a Chart widget and choose one of your dashboard widgets and the link field that connects it to this object. The chart then counts only the records linked to the record that is open: the value of the deals of this company, the open tasks of this project.

Plan limits

The number of dashboards, and of charts on one dashboard, depends on your plan. Nothing is removed if you move to a smaller plan. You just cannot add more until you are under the limit again.

In the API and for agents

Dashboards live under /api/v1/crm/dashboards with the crm:read and crm:write abilities. Agents use list_crm_dashboards, get_crm_dashboard (with the numbers), create_crm_dashboard, update_crm_dashboard, delete_crm_dashboard, add_crm_dashboard_widget, update_crm_dashboard_widget, remove_crm_dashboard_widget, arrange_crm_dashboard and preview_crm_chart. See the API and agents.