Dashboard

Overview

The dashboard (/admin/dashboard) is the page that opens after signing in to the admin console. It is a grid of tiles, called widgets, each answering one question. Two of its tiles are the most frequently misread numbers on the platform; see The two tiles that mislead.

Experiment on a copy. A change to the System dashboard is a change for everybody who opens Omaya, so only some roles can make it. Duplicate it, rearrange the copy, and share the copy with the roles that need it.

SPECIFICATION

• Permission: view-dashboard (View Dashboard), held by the shipped Admin, Manager and Viewer roles.
• Changing the System dashboard, resetting it, importing a layout into it and Set as Default for Everyone: manage-config-general (Manage General Config), held by the shipped Admin and Manager roles.

Dashboard options

An organisation can keep several dashboards; the dropdown at the top switches between them. The Dashboard options menu next to it holds the other actions:

Option	Function
New Dashboard	Creates an empty dashboard owned by the user, with a name (at most 15 characters), an Icon and an Icon Colour.
Rename	Renames one of the user's own dashboards.
Duplicate	Creates a copy owned by the user, with the same tiles. The safe way to experiment.
Set as My Default	Makes this the dashboard that opens first for the user. No other user's first screen changes.
Set as Default for Everyone	Makes this the dashboard that opens first for every user who has not chosen their own. Shown only with Manage General Config. It accepts the System dashboard or a dashboard shared with all admins, because every user must be able to open it.
Share / Visibility	Sets who can see one of the user's dashboards: Personal, Shared — All Admins or Shared — Selected Roles.
Reset to Default Layout	On the System dashboard only, with Manage General Config: restores the original tiles.
Export Layout · Import Layout	Saves the tile layout as a file, or loads one: the way to copy a layout to another dashboard or organisation.
Refresh Widgets	Reloads every tile.
Refresh Data	Discards the cached numbers and fetches fresh ones. Use it when a tile still shows a condition that has just been fixed.
Delete Dashboard	Deletes one of the user's own dashboards. The System dashboard and the last remaining dashboard cannot be deleted.

WARNING

Reset to Default Layout cannot be undone.

Which dashboard opens first

The user's own choice (Set as My Default, marked ★) if one was made; otherwise the organisation's default; otherwise the first dashboard the user can see. Setting a dashboard as one's own default does not change any other user's first screen. After that, the page reopens on the dashboard last viewed in that browser; the default is what a browser opens the first time.

The System dashboard is shared

Every user can open the System dashboard, and a change to it is seen by every user. Only admins whose role has Manage General Config can rearrange it, import a layout into it or reset it. For other users Edit Layout is not offered on it, and a Notes tile on it cannot be saved. Such users duplicate it and rearrange the copy.

The first-visit tour

The first time the dashboard is opened, a short tour points at Devices, Gateways, Zones, Rules and Reports in the menu. It opens once per account, on whichever computer or phone the user signs in with first. Skip tour, Finish, Esc, or a click on one of the highlighted menu items all count as completing it. To replay it, open the profile picture at the top right and choose Take the tour.

Data freshness

The tiles load when the page opens. Each number is cached for a short time so that a busy dashboard does not slow the platform down:

Tiles	Maximum lag
Live Devices, Recent Packets, Gateway Status, the Top rankings	10–30 seconds
Gateways, Live Sensor Status, Gateway List, Visitors Today, Hourly Packets, Entry / Exit Today	About one minute
Devices, Locations, Device Detection (24h), Visitor Trend, Dwell Time, BLE vs WiFi, Device Types	Up to five minutes
Right Now — Zones, Live Alerts Feed	Refresh themselves every 15 seconds
The six Building Status tiles	Refresh themselves every minute

NOTE

The dashboard answers "is anything wrong?". When a minute matters, use Right Now.

Default layout

The System dashboard shows these tiles until someone changes it, top to bottom. Eleven tiles are always present; a twelfth, Outside Now, is added for an organisation that has received outdoor GPS positions in the last 30 days.

Tile	Answers	Interpretation
Gateways	How many gateways, and how many are online, stale or offline	The first number to check when anything else looks wrong. One offline gateway explains a floor of missing data.
Devices	How many devices are registered, and how many are tags and sensors	Hardware owned, not hardware that works; the next tile covers that.
Live Sensor Status	Devices heard in the last five minutes (online), five to fifteen minutes ago (stale), or not for longer (offline), and how many report a battery under 20 %	A tag in a drawer is offline and in order. Offline includes devices that have been switched off.
Locations	How many sites	—
Device Detection (24h)	How many different devices were heard in each hour of the last 24, one bar per protocol	A gap in the bars indicates a gateway or network outage before anything else.
Gateway Status	The online / offline split, as a chart	The Gateways tile, drawn.
Live Devices	The 25 most recently heard devices (in the last five minutes) and the zone each is in now	Current positions, from the same positioning the floor plan uses.
Entry / Exit Today	Doorway crossings since local midnight	Crossings, not people in the building. A person who steps out for coffee is two entries and two exits.
Dwell Time	How long devices stayed, in buckets	A stay is one device in one zone: not a person and not a visit. Shows today, or the most recent day with data if today has none yet.
BLE vs WiFi	The traffic, by protocol	Mainly a health check: if a protocol in use drops to zero, something upstream has stopped. Shows the most recent day with data in the last week.
Device Types	Active devices by type: tags, sensors and so on	The shape of the estate. Gateways are not devices, so they are not included.
Outside Now	Who is outside right now, from outdoor GPS positions	Only for an organisation with GPS.

The two tiles that mislead

Visitors Today

Visitors Today is not on the default layout but is often added. It is the whole organisation's figure from Reports > Footfall: the distinct tags people carry, each counted once however many rooms it passed through. Tags on assets are left out, so it is the same number as the TV Dashboard's People seen today. A device that is not registered is never stored, so a visitor without a tag is not included. It counts tags, not heads: a person carrying two tags counts twice, and a person carrying nothing does not count. For door counts, see Entry / Exit; for which people report answers which question, see People-count reports.

Today's figure is refreshed every 15 minutes, so it grows through the day. If nothing has been heard yet today, the tile shows the most recent day with traffic rather than zero and a −100 % change. Visitors This Week adds up each day's figure since Monday, so a device present every day counts once a day. Visitor Trend (30d) draws the same figure day by day. A day on which the gateways sent nothing at all, usually a power or network problem at the site, is left as a gap in the line rather than drawn as zero, and so is a day too old to have a once-per-place count (see People-count reports). Top Locations and Top Venues rank by visits: each day's Footfall figure for the place, added up over the timeframe. Before 5 October 2026 these tiles added up every zone and every hour and read several times too high.

Entry / Exit Today

Entry / Exit Today counts crossings. It is not the number of people inside; entries minus exits equals that only when every door is counted. See people counters.

NOTE

For a real headcount, add Right Now — Zones. It shows the same fused occupancy as the Right Now page, with its source, so a tag count is never presented as a headcount. Occupancy: which number is which describes that tile.

Visitor tiles with an operating week

The dashboard has no filter bar, so the visitor tiles follow the organisation's own week, set under System > Configuration > Organisation. A floor's own week does not apply, because these are whole-organisation figures. With a Monday-to-Friday week set:

• Visitors Today is compared with the last open day, so a Monday is compared with Friday rather than an empty Sunday. Today is always shown, open or not.
• Visitors This Week adds up the open days so far, and states underneath the average per open day and what the closed days held (… on closed days not counted).
• Visitor Trend (30d) draws open days only, and the line under the chart states how many visits on how many closed days are not shown.
• Top Locations and Top Venues count open days only, with a line above the rows stating what the closed days held.

Nothing that happened on a closed day is lost: each tile states how much it left out. Without an operating week, every calendar day counts.

Editing the layout

1. Click Edit Layout. An Edit Mode bar appears above the grid, and every tile gets handles.
2. Click Add Widget on that bar to open the Widget Library at the side. Click a tile to add it, or drag it onto the grid to place it exactly; the search box at the top finds a tile by name. A tile that is already on the dashboard is greyed out in the library: each tile can appear once.
3. Drag a tile by its header to move it, and by its corner to resize it. Remove a tile with its close button.
4. Click Auto Arrange to pack the tiles upwards and close the gaps, keeping the existing order.
5. Click Save to keep the result, or Cancel to restore the layout as it was.

CAUTION

Nothing done in Edit Layout is stored until Save is clicked.

Widget Library

The tiles are listed in the groups used by the library.

NOTE

Live Sensor Status is not in the library. It comes with the System dashboard's default layout. To restore it to a copy from which it was removed, duplicate the System dashboard again.

Live KPI Stats

Tile	Shows
Gateways · Devices · Locations	As in the default layout
Entities	How many people, assets and guests are tracked, and how many have a tag bound now. If the user's role is limited to some labels (Entity access under System > Roles), it counts only those
Visitors Today	People's tags heard today, as described above
Visitors This Week	The same figure, added up since Monday (open days only, with an operating week)
License Days	Days left on the licence
Right Now — Zones	Occupancy per zone, with its source and status: the reliable headcount
Live Alerts Feed	What has fired recently

Charts

Tile	Shows
Device Detection (24h) · Entry / Exit Today · Dwell Time · BLE vs WiFi · Device Types · Gateway Status	As in the default layout
Hourly Packets	How many packets arrived in each of the last 24 hours. Volume, not devices
Visitor Trend (30d)	The Visitors Today figure, day by day; a day with no data is a gap, not zero

Top Rankings

These tiles have a Timeframe choice.

Tile	Shows
Top Locations · Top Venues	The busiest of each, by visits: each day's devices, counted once per place, added up
Top Gateways · Top Devices	The busiest of each, by traffic
Top Crowd Flows	The most common zone-to-zone movements: which room leads to which

Live Monitor

Tile	Shows
Floor Plan Slide	Each venue's plan with live devices drawn on it, cycling
Location Overview	Each site with its venue, zone and gateway counts, cycling
Outside Now	Who is outside right now. Listed only for an organisation with outdoor GPS positions

Building Status

These six tiles answer a different question from the rest of the library. The other tiles count how many people came; these state whether the building is in order at this moment. Each refreshes itself every minute and links to the page it summarises.

Tile	Shows
Panic & Button Presses	Presses today, how many matched a routing, man-down alarms, and every registered button with when it was last heard
Security Watch	Open and critical incidents, what was resolved today, and the worst still open
Environment Now	Inside against outside: temperature and humidity from the fixed sensors against the weather at the location, with a 24-hour line and a per-zone breakdown
Occupancy vs Capacity	Each zone that has a capacity, drawn against it, plus today's breaches
Battery Attention	Devices at critical or low charge, worst first, with days left where that can be forecast
Work Orders	Open, overdue and unassigned work orders, worst first by priority then due date

A tile whose feature the organisation does not have states this rather than showing zero. Security Watch on an organisation without the app, or Occupancy vs Capacity before any zone has a capacity, states what is missing.

Tables & Utility

Tile	Shows
Live Devices	As in the default layout
Gateway List	Every gateway, its state and its last report
Recent Packets	The last packets received, decoded: the tile that confirms data is arriving
Clock	The time, in the organisation's timezone
Notes	A note typed on the tile and kept with its own Save button. Every user who can see the dashboard sees it
Quick Links	Four fixed shortcuts: app users, devices, reports and settings
Tenant Info	The organisation's details and plan
Audit Trail	Recent administrator actions

Dashboards from a starter pack

Each starter pack can add a dashboard for its industry (Retail, Warehouse, Healthcare and so on), built from the widgets in the library and shared with every administrator. It does not replace the organisation's default unless Make it the organisation's default is ticked. It can be changed like any other dashboard; once it has been changed, Remove on the pack keeps it.

Setting up a dashboard for a role

Applicable versions / plans

SPECIFICATION

• Permission: view-dashboard to create, duplicate, rename and share one's own dashboards.
• Shared with Shared — Selected Roles: the roles must exist under System > Roles.

Requirements

At Northwind Tower, Aisha Rahman keeps the System dashboard unchanged and builds two copies: one for the facilities team and one for the guards, so that each team sees only the tiles relevant to its work.

• A "Facilities" dashboard with occupancy, battery, work-order and flow tiles.
• A security dashboard with panic-button, incident and alert tiles.
• Each dashboard shared only with the role that uses it.

Restrictions

• Dashboard name: at most 15 characters.
• Each tile can appear once per dashboard.
• Only the owner of a dashboard can rename, share or delete it. The System dashboard keeps its name.

Configuration roadmap

(1) Duplicate the System dashboard and rename the copy.

(2) Edit the layout of the copy and save it.

(3) Share the copy with the role that uses it.

(4) Repeat for the second role.

Procedure

1. Open the System dashboard and choose Dashboard options > Duplicate.
2. Choose Dashboard options > Rename and set the name to Facilities.
3. Click Edit Layout, then Add Widget. Add Right Now — Zones, Occupancy vs Capacity, Battery Attention, Work Orders and Top Crowd Flows. Remove BLE vs WiFi and Device Types. Click Save.
4. Choose Dashboard options > Share / Visibility, select Shared — Selected Roles, tick the facilities role and click Save.
5. Repeat steps 1 to 4 for the guards, with Panic & Button Presses, Security Watch and Live Alerts Feed, shared with the security role.

Recommended tile sets

• All users: Gateways, Live Sensor Status, Right Now — Zones, Live Alerts Feed. These four tiles show whether the platform is working and what it sees.
• Facilities: add the Building Status tiles, Top Crowd Flows, Dwell Time and the Floor Plan Slide.
• Budget holders: add License Days and Entities.

Verification

• The dashboard dropdown lists the new dashboards.
• A user in the facilities role sees Facilities in the dropdown; a user in any other role does not.
• Set as Default for Everyone on a dashboard that is not shared with all admins is refused with The default for everyone must be a dashboard everyone can open: the System dashboard, or one shared with all admins.

Troubleshooting

Symptom	Cause	Action
Every count is zero.	No gateways online, so no data. Every other tile depends on the gateways.	Check the Gateways tile first.
Visitors Today shows yesterday's number.	Nothing has been heard yet today, so the tile shows the most recent day with traffic (see Visitors Today).	None. Once today has devices, the tile switches to today and grows every 15 minutes.
The visitor tiles changed when opening days were set.	With an operating week, they count open days only and state what the closed days held.	None; see Visitor tiles with an operating week.
The Visitor Trend line has a gap.	No data arrived that day; the gateways sent nothing, usually because of power or the network at the site. It is not a day on which nobody came.	Check Gateways, and Footfall for the same day, which states No data received.
A tile states "temporarily unavailable".	Its data source failed. The failure is logged and the rest of the dashboard is unaffected.	Click Refresh Data. If it persists, the cause is usually a report table not yet created for the current month; report it to the platform operator.
A chart states Live history is not set up.	The full text is Live history isn't set up for this organisation yet — contact support. The organisation's live data store was never set up.	Report it to the platform operator; it cannot be fixed from the console.
Live Devices is empty but devices are online.	Positioning has not placed them yet: they are heard but not yet in a zone.	Wait a few minutes, then check that the venue has gateways placed on its plan.
Colleagues report that the tiles moved.	The System dashboard was edited.	Click Reset to Default Layout, then work in a copy.
The System dashboard cannot be rearranged.	The role does not have Manage General Config. Attempts are refused with Only an administrator whose role has Manage General Config can change the System dashboard. Duplicate it and change the copy.	Duplicate it and rearrange the copy.
The dashboard opened on another user's layout.	Someone changed the default for everyone, and the user never chose a default.	Open the preferred dashboard and choose Set as My Default.
A tile is greyed out in the library.	It is already on this dashboard; each tile appears once per dashboard.	None.