Dashboards
A dashboard is a panel of widgets that sits beside a map. Each data widget summarizes one layer of the map, and a text widget holds notes in Markdown. A map has one dashboard, and a dashboard holds up to 50 widgets.
Build a dashboard
Section titled “Build a dashboard”In the map builder, open the Dashboard panel in the dock. Its description reads “Widgets readers see beside the map”. It needs at least one vector or table layer on the map. On a map with widgets, the rail button carries a dot and its name gives the count, such as “Dashboard (6 widgets)”. The panel opens when the map loads unless you closed it on that map before, which your browser remembers per map; on a narrow screen it stays closed.
Panel position puts the panel Right of the map or Below the map. On a narrow screen it is always below.
Hide the map removes the map so the widgets fill the page. No map loads, and readers see the widgets across the full page in the viewer, on share links and in embeds. Charts and tables then take two columns. A widget that follows the map view covers the whole layer instead, and a feature list has no map to zoom.
Reader theme is Follow the reader, Light or Dark. Follow the reader uses the reader’s own light or dark setting.
Add a widget, then choose its layer and settings. Every widget has an optional Title. A widget without one is named from its own settings, such as “Sum of mag” for an indicator or “Count by Magnitude type” for a bar chart. Labels, legends and data tables use each column’s title from the dataset’s attribute metadata when it has one.
| Widget | What it shows | Settings |
|---|---|---|
| Indicator | One number | Statistic: Count, Sum, Average, Minimum or Maximum. Sum, Average, Minimum and Maximum also take a numeric Column. Optionally a Reference value; see Compare an indicator with a reference. |
| Bar chart | Bars, by the Bars show setting | Values of a column: one bar per value. Group by is the column whose values become bars. Dates: one bar per Day, Week, Month or Year of a Date column, counted in UTC. One bar per feature: a Label field names each bar and a numeric Value field sizes it, with Sort by and Order. One bar per field: pick up to 20 numeric Fields, one bar each. Every mode takes a Statistic and Bars (1 to 50, default 10) where they apply. |
| Pie chart | How a total splits across the values of a column | Group by, Statistic, a numeric Column for Sum, Average, Minimum and Maximum, and Slices (1 to 50, default 10). Slices beyond that merge into Other. |
| Histogram | How the values of a numeric column spread | Column and Bins (2 to 50, default 20). On a whole-number column the bins are whole numbers, so a short range can have fewer bins than you asked for. |
| Table | Statistics grouped by the values of a column | Group by, and up to five statistics, each with Add a statistic, Sort by and Order, and Rows (1 to 50, default 10). |
| Feature list | A layer’s features, one row each | Title column, an optional Subtitle column, Sort by and Order, and Features per page (10 to 100, default 25). Load more reads the next page. Each row has a button that zooms the map to the feature. |
| Category selector | A list of a column’s values to choose from | Column, and Readers can pick more than one value (on by default). |
| Text | Notes for readers, such as how to read the dashboard | Text in Markdown. Headings, lists and links work; HTML and images aren’t shown. A text widget has no layer, so filters, the map view and hidden layers leave it as it is. |
A new bar chart or category selector starts on a text column that has few distinct values, not on a nearly unique one such as a place name.
A bar chart or pie chart that groups by the column the layer’s map style colours by can draw its bars or slices in the layer’s colours. Use the layer’s colours turns that on or off. A histogram labels its axis with tick values.
Compare an indicator with a reference
Section titled “Compare an indicator with a reference”Enter a Reference value and an optional Reference label, such as “Target”, and the indicator shows its difference from that number, for example “12 above Target”. Show the difference as picks Value, Percent change or Value and percent change. A higher value is better decides whether a value above the reference reads as favorable; the indicator carries that judgement in colour and in its text.
What a widget covers
Section titled “What a widget covers”Covers sets the scope of a widget:
- The whole layer summarizes every feature the layer’s filter lets through.
- What’s in the map view recalculates once the map stops moving. It needs a layer with geometry. When the view holds too many features, the widget says “Too many features in view. Zoom in to see these numbers.”
Preview and save
Section titled “Preview and save”Preview panel shows the panel as readers see it, with a placeholder for the map. Each widget also previews against the map.
A save is held while a widget reads a column its layer lacks or that isn’t numeric when it has to be, or follows the map view on a layer with no geometry. The widget says what to fix.
A widget on a column outside a non-public dataset’s column allowlist shows “Embedded copies of this map can’t show this column.” Share links and public datasets are unaffected.
Read a dashboard
Section titled “Read a dashboard”The panel shows on the map page, on share links and in embeds. A reader can
collapse it with Hide dashboard and reopen it with Open dashboard. An
embed can open it collapsed with dashboard=collapsed, which the Share panel
sets with Start with the dashboard collapsed. See
Sharing & embedding.
Each widget applies its layer’s saved filter. When it can’t, it says so and shows all features. A widget on a layer the reader turns off in the legend leaves the panel.
Hide the map
Section titled “Hide the map”When the author hides the map, readers see only the widgets, across the full page. Widgets that cover what’s in the map view cover the whole layer, and a feature list shows “This dashboard has no map, so features cannot be zoomed to.” Picking a bar or a slice still filters the other widgets.
Filter the map from a widget
Section titled “Filter the map from a widget”Click a bar or a histogram bin, or choose values in a category selector, to filter that layer on the map and the other widgets. The keyboard works too: arrow keys move between bars and bins, and Enter or Space applies the filter.
Each filter shows as a chip under Filters, and the chips stay while the panel is collapsed. A chip clears its filter. A filter applies on top of the layer’s saved filter and is never saved. The widget a filter came from keeps showing every value, with the picked ones marked.
A widget on a column the server can’t filter by doesn’t offer filters. If a layer is hidden, its filters step aside until it is shown again.
Reproduce a number
Section titled “Reproduce a number”Each data widget is one call to the dataset aggregate route. A script that sends the same operation with the same filter gets the same number; see Aggregate a dataset.
Dashboards from ArcGIS
Section titled “Dashboards from ArcGIS”geolens arcgis migrate doesn’t convert ArcGIS Dashboards. Its migration report
points a dashboard with no map widget to a GeoLens dashboard with the map
hidden, and names a dashboard with several maps so you can convert it to a
single-map dashboard or split it. See the
CLI guide.
On the Maps page
Section titled “On the Maps page”A map with a dashboard you can see carries a Dashboard badge in the list and grid views.
See also
Section titled “See also”- Map builder: layers, filters and sharing
- Map data: the table of a layer’s rows, which follows these filters
- Stories: scenes on saved maps