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
- Choose New dashboard, give it a name and decide who sees it: Only me or Everyone in the workspace.
- Choose Add widget, pick a kind, an object and what to measure, and watch the preview change.
- 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.
- 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.
