Dashboard parameters

Individual queries have their own parameters. A dashboard adds one more layer on top: a shared filter bar that broadcasts values to every widget whose underlying query happens to use a parameter of the same name.

How the mapping works

arcodash scans every widget’s query for {{ name }} tokens and collects the distinct parameter names across the whole dashboard. Each distinct name gets one input in the dashboard’s parameter bar — there’s no separate step to “map” a parameter to a widget; the mapping is just name matching.

When you set a value in the parameter bar, that value is sent to every widget’s query, and each query only picks up the names it actually references — a widget whose query doesn’t use {{ region }} simply ignores the region value being broadcast, the same way any unreferenced key in a values object is ignored.

[!TIP] Two widgets built on different queries that both reference {{ region }} will filter together from the one dashboard-level input. Name the parameter the same way in both queries’ SQL to get this for free — there’s no dashboard-level renaming or aliasing.

Per-widget vs. shared

There’s no per-widget override in the dashboard parameter bar itself — a value you set there applies everywhere that name is used. If one widget needs to be filtered independently of the rest, give its query’s parameter a different name so it doesn’t collide with the shared one, or leave that widget on a query with no parameters at all.

Setting values live-filters, it doesn’t re-save anything

Values you type into the dashboard’s parameter bar only affect what you (or whoever’s viewing right now) sees in the browser — they’re never written back into the dashboard’s saved state. Reloading the dashboard clears them back to empty.

[!NOTE] Dashboard-level parameter values aren’t available on a public link or an embed — a public/embed view always shows the dashboard’s last cached result, with no live re-querying. See Public links.

Where to go next

• Parameters — the full type list and the Text-type security rule that also governs what a dashboard parameter can safely drive.
• Building dashboards — adding the widgets a parameter bar ends up filtering.