Configure your CRM dashboard

The landing screen after sign-in: chart, timeline, calendar and map widgets over your CRM data, dashboard views, the widget editor and all keyboard shortcuts.

What does the Dashboard show, and can I share widgets with my team?

The Dashboard is where you land after sign-in. It shows widgets over your CRM data: pipelines, task counts, recent activity, whatever you set up. Every widget belongs to you. Teammates see it only after you turn on Share as a template in its editor, and then they start their own copy from it. Adding widgets needs no role permission, but a chart counts only the records your role can read, so a teammate's copy can show other numbers. Add widget appears only if your role can read at least one list. In a workspace without lists, the Dashboard says so and offers Create list to people who manage the data model.

Can I have several dashboards?

Yes. The view chips above the widgets switch to your own named dashboards, for example one per team or purpose; with none selected you see the main dashboard, and clicking the selected view again goes back to it. New view adds one, and V opens the view picker, as on a list. Each view keeps its own widgets and arrangement, a new widget lands on the view you are looking at, and a link to a view opens that dashboard for you. Views and their widgets are yours until you share them: Share… in a view's menu shows it to everyone in the workspace or to selected roles, as on a list. Teammates then find it after their own views as a chip with your photo and see the same widgets and layout, read-only; every number is calculated with their own access. Only you can change the widgets; Duplicate as new view gives a teammate their own copy with all widgets and their arrangement, which they can change freely without touching yours. Duplicating one of your own views copies its widgets the same way. The main dashboard cannot be shared; share a named view instead. A colleague who opens the link of a view that is not shared with them sees their own dashboard. Deleting a view moves it to Trash together with its widgets, and the confirmation names them; Undo or Restore brings both back.

Yes, with a public link. In a dashboard view you own, open Share…, choose Anyone with the link and click Save; the link is created and copied, and everyone in the workspace sees the view too. Anyone with the link then sees that view's charts and numbers live, read-only and without signing in, at an address ending in /p/…; the page shows the view's name and your workspace name. The numbers are calculated with your access, so a public link never shows more than you can see yourself. Clicking a bar or a number opens the records behind it, read-only and with your access, showing the record name and the fields the chart groups by or sums; visitors can search, filter, sort and adjust columns in the drawer, but only on the columns shown, and nothing is saved; nothing can be changed, and records do not open on their own pages. Lists, calendars, maps and activity timelines are left out. Anyone with the link sees those charts and records, so publish only boards you are happy to show. Copy copies the link again at any time, Last day the link opens (UTC) sets an optional end date, and the dialog shows how often the link was opened. Choosing another option and saving stops the link at once; choosing Anyone with the link again creates a new address. Saved list views can be published the same way (Lists). While the link is on, your view's chip shows a globe.

Publishing needs Create on the Public links row of your role; the Admin role has it. Allow public links in General turns every public link of the workspace off and on again; while it is off, each link shows Link not available. A link also stops working when it expires, when the view moves to Trash, or when its creator loses the permission, is deactivated or leaves the workspace. Creating and turning off a link appear in Audit log. The main dashboard cannot be published; publish a named view. Mate and other MCP clients publish with manage_data_views action publish, and the REST endpoint is POST /api/v1/data-views/publish; publishing there also shows the view to everyone in the workspace, and sharing it privately or with roles turns the link off.

Which widget types exist, and which charts can they show?

Click Add widget to open Choose a Widget. Start from scratch comes first, with one card per chart style (Number, Bar chart, Horizontal bars, Area over time, Ranked table, Doughnut, Funnel and Radar) plus Activity timeline, Upcoming, Month overview and Map; a card opens the editor with that style already chosen, and you pick the data. Start from a template lists widgets teammates shared. To have a widget built for you, describe it with Ask Mate in the widget editor.

  • A chart aggregates one list: count, sum, average, minimum or maximum of a number field. Group by a field, by each record, by Assigned to (a record with two assignees counts for both) or through a relationship, for example Deal value by stage or line item amounts by service. Each source record counts once per group, so a deal linked to two organizations counts fully for both. To plot a time series, group by a date field, Created at or Updated at and choose a Time interval (day, week starting Monday, month, quarter or year). Times are bucketed in the time zone of the browser that saved the widget; date-only values never shift, and records without a date are counted below the chart.
  • Activity timeline is a newest-first feed of changes, messages and channel activity. Its filters belong to that widget, so several timelines can show different things without affecting each other or a record's Activities view.
  • Upcoming lists the records of one list by a date or date-time field for the next days (14 by default, up to 90), with an Overdue section for earlier dates and an optional amount column. Filter out finished records, for example tasks that are done, so that only open ones count as overdue.
  • Month overview colors each day of a month by how many records fall on it or by the sum of a number or currency field. The arrows change the month, and a day opens a list of its records.
  • Map places the records of one list at the position stored with an address field and groups records that are close together into numbered clusters. A single-choice field colors the pins in the colors of its options, the same as on charts, a number or currency field sizes them, and a pin opens a card with the name, the address, an optional detail field and Open record. A cluster takes the color of more than half of its records; without such a majority it is an uncolored ring, which the legend lists as Mixed.

Under Appearance, a chart can be a vertical or horizontal bar chart (with or without labels), a doughnut or a radar chart, or one of these:

StyleShowsNeeds
NumberOne overall valueNo grouping
Area over timeA value per period; empty periods are zero for counts and sums and a gap otherwiseA time interval
Ranked tableGroups by value with their share of the total, top ten plus the restA grouping
FunnelEach option in order with step-to-step conversion; a stage with probability 0, such as Lost, is listed belowA single choice field such as a stage

A style that does not fit the grouping is disabled with a hint. Calculated values need access to their inputs.

What can an activity timeline show, including calendar events?

A timeline shows the same entries as Audit log: record changes with their previous and current values, admin and configuration changes, messages, channel activity such as accepted LinkedIn connections, and meetings from the calendar of a connected Gmail or Outlook account (the calendar layout of a list and the calendar widgets show records by their date fields, not meetings). Filter it by Activity type, Provider, Channel, Conversation or Related records, and limit it to record types or records, or to a From and Until date. Related records use Includes any of, Excludes all of, Has a linked record and Has no linked record. Different filters must all match; several values in one filter match any of them.

Load older shows the next page. A row can link one primary record and up to three related records, and a message can open its Inbox thread. Rows without a record stay visible without a link.

How do calendar widgets handle dates and time zones?

A date-only field is a calendar day and never shifts. A date-time field is placed on the day it falls on in the widget's time zone, which is the time zone of the browser that created the widget; "today" and Overdue follow the same time zone. The date field may also be a date range or date-time range: the record appears on the day its range starts and counts as overdue once its range has ended. Upcoming shows up to 100 records and up to 20 overdue ones with their total. Month overview counts or sums every record of the month, and a day lists up to 100 of its records. Both use the same filters, record access and field permissions as charts, so a teammate's copy of a shared template shows only what that teammate may read.

Where does the map come from, and which records are missing from it?

The map shows country borders, regions and cities from Natural Earth (public domain). These map files ship with Customermates and are served by your own Customermates server, so opening a map sends no request to an outside map, tile, font or geocoding service, and a self-hosted server shows maps without internet access. The map files load only when a map widget is on screen.

A record appears where its address field stores a position: the center of the postal code area once the postal code directory knows the code, or the building after an address search on a self-hosted server with Photon (see How do I enter an address?). Records without an address, without a stored position, or whose address you may not read are counted in the hint below the map instead. A map shows at most 2,000 records; narrow the filters if the widget says it shows only part of them. Zoom with the buttons, the keyboard (+ and -, arrow keys to move, 0 to reset) or the mouse wheel while you hold Cmd/Ctrl; once you have selected the map, the wheel zooms without the key. On a touch screen, one finger scrolls the page and two fingers move and zoom the map. Select a cluster to zoom into it.

Who sees what in a timeline?

AccessVisible content
Activity log onlyPermitted changes
Inbox messages only, on a plan with messagingPermitted messages, channel activity and meetings
BothOne merged timeline
NeitherA notice that no activity is available

The two permissions are the Activity log and Inbox messages rows of the member's role in Roles, each with Read access All. Messages, channel activity and meetings also need Customermates Cloud and a plan with messaging (Pro and above); changes stay visible without it. A deleted or no longer accessible filter value stops matching and shows as Filter not available on the chip and Selection unavailable in the picker, so you can remove it.

How do I create or edit a chart or timeline widget in the widget editor?

Pick a chart style, Activity timeline, Upcoming, Month overview, Map or a template in Choose a Widget; all of them open the same editor. Give the widget a name, then switch between Data and Appearance. Data holds the source and what to count; filters and grouping are collapsible sections inside it, and once you group, Group filters limits which records appear as groups. Both filter sections show the same searchable Filters palette as a list, and linked fields appear as List › Field. Appearance holds the chart style, colors, the legend, Show metric and filters and Share as a template. The Live preview above the settings shows the widget with real data and updates as you change things; select Dashboard size to see it in the proportions it takes on the dashboard. Click Save in the footer.

Click a chart or one of its bars to open its data drawer: the chart remains at the top and the contributing records appear below, with the normal list filters and pagination. Selecting another group changes the records. Open in list opens the normal overview with the same selection and any extra filters; it queries the full matching data rather than a sample of record IDs. Clicking a row opens its record. To edit a widget, use the pencil shown on hover or keyboard focus, or choose Edit from its local menu (also available by right-click). Clicking a filter chip opens the editor at that filter. Reset restores the saved values once you changed something, and the trash icon in the editor's header moves the widget to Trash after a confirmation. A new widget takes the first free spot. Drag a widget to move it and drag an edge or corner to resize it (moving is off on touch devices); the arrangement is saved for you only. Heights snap to rows of 54 px; chart and Number widgets are at least two rows tall, an Activity timeline at least six rows tall and two columns wide, a calendar widget at least five rows tall and two columns wide, and a Map at least five rows tall and three columns wide.

Which controls does the sidebar add?

The sidebar holds your work and looks the same on every screen. At the top are Search (Cmd/Ctrl+K, see Global search), Ask Mate (Cmd/Ctrl+J, see the assistant) and Add (C). Below are Overview with the Dashboard, Knowledge Base, Calendar, Inbox and Automations, then Data with your lists, then your personal sections. Entries your role cannot open are hidden. Inbox counts unread conversations.

The sidebar is yours: drag an entry to reorder it or move it to another section, or use its … menu for Move up, Move down, Move to section (including New section) and Hide from sidebar. Click a section title to collapse it; its … menu (or a right-click) offers Move up and Move down, and on sections you created also Rename and Delete section. Deleting a section moves its entries back to their default place; hidden entries stay hidden. Customize sidebar in the personal menu opens a dialog with a switch per entry to show or hide it, New section, and, once you changed something, Reset to default, which after a confirmation restores the standard layout. Nobody else sees your changes.

The workspace name at the top opens the workspace menu: the workspaces you belong to, to switch between them, Create workspace, Invite members (if you may invite), Members, Settings, Billing with a chip for your plan and its status, and, for Customermates operators, Operator Console. Your avatar opens the personal menu: Profile & preferences, Theme (System, Light or Dark), Language, Keyboard shortcuts, Documentation, Send feedback, Customize sidebar and Sign Out. Settings and G then S open Profile & preferences, and the sidebar switches to the settings navigation with Account (Profile & preferences, Workspaces, Channels & calendars, API keys & connectors) and Workspace (General, Members, Roles, Billing, Audit log, Webhooks); Back at its top returns to the page you came from. Customize sidebar is not offered while the settings navigation is shown. Until you confirm your address, your avatar and the Profile & preferences entry show Email not verified.

Which keyboard shortcuts are there?

Press ? or choose Keyboard shortcuts in the personal menu to see every shortcut with the keys of your computer (⌘ on a Mac, Ctrl elsewhere), grouped and searchable. Cmd/Ctrl shortcuts and Esc work everywhere, even while you type. Single keys and G sequences work only when no text field has focus and no menu or dialog is open.

GroupKeysWhat it does
GeneralCmd/Ctrl+K or /Search; type a question and press Tab to ask Mate instead
GeneralCmd/Ctrl+JAsk Mate (opens or closes the assistant)
General?Show keyboard shortcuts
GeneralCmd/Ctrl+\Show or hide the sidebar
NavigationG then D, I, K, R, CDashboard, Inbox, Knowledge Base, Routines, Data model
NavigationG then SSettings
NavigationG then WSwitch workspace, when you belong to more than one
CreateCAdd a record or list
Lists and viewsG then 1 to 9Lists by their position in your sidebar; hidden lists are skipped
Lists and viewsVSwitch view on a list or the Dashboard
Lists and viewsFOpen search and filters on a list
FormsCmd/Ctrl+EnterSave the open form
FormsEscClose the topmost dialog or drawer

After G you have about one second for the second key; a hint shows that the app is waiting. Shortcuts for pages your role cannot open are left out. Search lists the same commands with their keys: Ask Mate on top, the views of the list you are on, the pages, Add and, with more than one workspace, Switch workspace…. If you use speech input or press keys by accident, turn off Single-key shortcuts at the bottom of the shortcut dialog; Cmd/Ctrl shortcuts keep working. The setting is personal and follows you to every device.

What happens on first run?

New accounts go through the onboarding wizard before they see the Dashboard: your profile, the Knowledge Base, team invites and connecting an AI client. The owner can skip website import, invitations and the AI connection; invited members see only their profile.

For agents

Create and change widgets with manage_widgets rather than driving the editor; it supports the same options as the app. Read a widget before updating it, because a supplied measure or displayOptions object replaces the whole object, and pass the current expectedRevision, an idempotencyKey and, for updates, expectedVersion. A time series sets groupBy.dateInterval and an IANA groupBy.timeZone; timelines use activityQuery, calendar widgets calendarQuery (layout upcoming or month, the date field, an IANA timeZone) and maps mapQuery (the address field plus optional color, size and detail fields). get reads a calendar widget for another window of up to 42 days, such as one month or one day. The widget kind cannot change. An optional layout places a widget in the same call: x and w count columns of the 12-column grid, y and h count rows of 54 px. Chart and Number widgets need an h of at least 2, an activity timeline a w of at least 2 and an h of at least 6, a calendar a w of at least 2 and an h of at least 5, a map a w of at least 3 and an h of at least 5, and overlapping positions are refused. Empty rows between widgets are allowed; the dashboard moves widgets up into them. get_calendars reads calendar events. Exact schemas are in the MCP catalog.

Which REST endpoints manage widgets?

Over REST, POST /api/v1/widgets/list returns every widget across your dashboard views with its viewId and layout, POST /api/v1/widgets/save creates or updates one, POST /api/v1/widgets/layout moves and resizes several at once, and POST /api/v1/widgets/delete moves one to Trash. To create a timeline, calendar or map with widgets/save, send kind: "activityTimeline", "calendar" or "map"; without kind a new widget is a chart, an update may leave out settings that stay the same, and a different kind on an update is refused with widgetKindImmutable. POST /api/v1/widgets/read returns one widget with its current results; for a calendar widget it also accepts a window with from and to. Dashboard views are saved views of the dashboard surface under /api/v1/data-views/.