Dashboard design

Dashboard Requirements

Also called: Dashboard requirements document, BI requirements, Report requirements, Dashboard brief

Dashboard requirements are the agreed answers to who a dashboard is for, which questions it must answer, and which metrics, filters, data sources and refresh schedule it needs.

One-page requirements brief for a sales performance dashboard: audience and use, three business questions, a KPI table with definitions and targets (revenue $3.0M, win rate 30%, pipeline coverage 3.0×), filters for region and quarter, CRM as the data source and a daily refresh.

What the requirements cover

Good requirements fit on one page. The example covers the six things a developer needs before designing anything:

  1. Audience and use. Sales leadership, in the weekly pipeline review. This decides how dense the page can be and how often it needs to refresh.
  2. Questions. Three plain-language questions the page must answer. Everything on the dashboard should trace back to one of them.
  3. KPIs with definitions and targets. “Revenue” isn’t a requirement. “Closed-won revenue, by close date, against a $3.0M quarterly target” is.
  4. Filters. Region and quarter. Each filter is a promise that every visual still makes sense when it’s applied.
  5. Data sources. Where each number comes from, and who owns that source.
  6. Refresh and access. How fresh the data must be and who can see it.

From questions to visuals

Three business questions mapped to a metric and a visual: are we on track for the quarter maps to revenue against target in a KPI card; which regions are behind maps to revenue by region in a bar chart; is the trend improving maps to monthly revenue in a column chart

The most useful habit in requirements gathering is to write the question first, then the metric that answers it, then the visual. It stops two common problems: charts nobody asked for, and questions nobody answered.

If a stakeholder asks for a specific chart (“we need a pie chart of regions”), ask what they’d decide from it. The answer is the real requirement, and it may be better served by a different visual.

Functional and non-functional requirements

Functional (what it shows and does)Non-functional (how it runs)
KPIs, definitions and targetsData refresh frequency
Visuals and the questions they answerWho can access it, and row-level restrictions
Filters, drill-downs, navigationPerformance (how fast pages must load)
Export or subscription needsDevices: desktop, mobile, wall screen

Non-functional requirements are easy to forget in a workshop and expensive to discover after launch, especially access rules and refresh times.

Best practices

  • Talk about decisions, not charts. “What would you do differently if this number dropped?” gets better requirements than “what charts do you want?”
  • Define every KPI in writing. Include the filter logic, time frame and target. Two teams often calculate “active customer” differently.
  • Keep the question list short. Three to five per page. More than that is usually two dashboards for two audiences.
  • Turn requirements into a mockup quickly. People find it much easier to react to a picture than to approve a list.
  • Record what’s out of scope. It’s the easiest way to stop the dashboard growing during the build.

Mocking up the requirements

A requirements list becomes real when stakeholders see it as a dashboard mockup, and that’s usually when the missing requirements surface. Our guide to mocking up a Power BI dashboard before you build it starts with that requirements conversation.

Related terms

Common questions

What should a dashboard requirements document include?
The audience and how they'll use it, the three to five questions it must answer, each KPI with its definition and target, the filters and drill-downs needed, the data sources, the refresh schedule, and who has access. One page is usually enough.
What questions should I ask stakeholders when gathering dashboard requirements?
Ask what decision they make with this information, how often they make it, what they look at today, what number they'd check first, and what 'good' looks like for each metric. Ask about decisions rather than charts.
Who signs off dashboard requirements?
The person who owns the decisions the dashboard supports, usually the business lead who asked for it. Agree who that is at the start, so feedback from other people is input rather than a veto.

Mock it up before you build it

Lay out your Power BI or Tableau dashboard in Mockko, get sign-off, then build. Free to start.

Try Mockko free