Stop Confusion Before It Starts
Confusion around dashboards can happen because users assume a widget works differently than it actually does.
Dashboards are not flexible tools. They are deliberately strict by design.
Fixed Widget Logic
Every dashboard widget is powered by fixed system logic.
Each widget has:
A predefined data source
Predefined calculation rules
A predefined date range
These cannot be edited.
Users cannot:
Change what records are included
Change the date window
Add filters
Modify how totals are calculated
This is by design.
Why?
Dashboards are expected to show consistent numbers across the business.
If every user could change logic, the system would lose credibility.
What You CAN Customise: Wording
While the logic cannot change, wording can.
Desktop users can:
Edit widget titles
Edit widget descriptions
This allows teams to use clearer internal language without affecting the data.
Changing wording does not:
Change counts
Change filters
Change date logic
It only improves clarity.
How to Write a Good Widget Description
A good widget description should clearly explain three things:
What the widget is measuring
Which records are included
What date range applies
If any of these are missing, confusion follows.
Practical Example
Instead of writing:
“Jobs due soon”
Write:
“Open jobs with an RCD from today to the next 6 days.”
That description:
Mirrors the actual system logic
Matches the spec
Leaves no room for interpretation
Clear descriptions prevent arguments.