Skip to content

Dashboards and widgets

A dashboard is a screen of widgets. It can be a company dashboard (seen by everyone or only some roles) or a personal one (only you). Widget types:

  • Collection: records, figures and charts. Modes: value (one number), group (by category), list (latest records with columns) and trend (by day, week or month). Aggregates: count, distinct, sum, average, min and max.
  • IoT: values, charts, maps, buttons and device status from MQTT.
  • Script value: a number published by a script.
  • Content for screens: video, image, gallery, announcement, QR or clock, fixed or from a collection with validity dates.
  • Actions: buttons for daily operations (create record, next in queue, script, flow or link).
  1. Open Dashboard in the menu and create one: «New company dashboard» or «New personal dashboard».
  2. Click Customize (Personalizar) → Add widget, choose the type and configure it (title, size from 1 to 4 columns, filters, period).
  3. A collection list can have actions on its rows: state transitions and row actions.
  4. In «Name and visibility» (Nombre y visibilidad) choose which roles see a company dashboard.
  • Up to 40 widgets per dashboard and 10 personal dashboards per person.
  • A company dashboard requires dashboards:edit to create or change it; a personal one only needs dashboards:view.
  • Each person sees data with their own permissions: what they cannot read shows as «(no access)» or «—».
  • get_dashboard_widget_guide: each widget’s shape, filters and examples; with collectionId, the useful fields. Read it before configuring.
  • list_dashboards, get_dashboard.
  • create_dashboard (personal: true for your own), update_dashboard (name, icon, roles) and set_dashboard_widgets (replaces the whole configuration: read it first with get_dashboard).