Passing parameters and filters via URL in Tableau is nothing new. It’s a well-established technique, widely documented (such as knowledge articles or various blogs (e.g. Flerlage Twins)) and commonly used to create seamless navigation between dashboards, especially when paired with URL actions to carry context (like filters) across workbooks.
In practice, this is incredibly powerful. At work, for example, we use this pattern to let users move from a high-level performance dashboard into a more detailed breakdown, all while preserving the relevant context via URL actions.
Recently, we ran into a case where passing a parameter via URL simply didn’t work, despite everything being configured correctly.
The Problem
A colleague, Simon, was implementing this approach, but the parameter refused to update via the URL.
Everything checked out –
- Parameter name matched exactly
- Values were valid
- URL syntax was correct
But –
- The parameter stayed at its default value
- It did not update when the URL changed
- Even a text object bound to the parameter did not reflect the value
There were no obvious errors, and none of the usual fixes made any difference.
The Setup
The issue occurred on a landing page dashboard (“Title Page”).
The dashboard was intentionally simple –
- A text object displaying the parameter value
- Some images for branding
- No charts or data
And importantly –
There were no worksheets on the dashboard.
The Gotcha
After some further digging and troubleshooting, the issue came down to this –
If the landing dashboard does not contain at least one worksheet, URL parameters will not apply.
Even if –
- The parameter is valid
- The URL is correct
- The parameter is directly referenced in a text object
It will still not update.
The Solution
The fix was straightforward, discovered by Simon after he changed the text object displaying the parameter value to a worksheet instead.
So, for URL parameters to apply and stick –
Add at least one worksheet to the dashboard.
The worksheet doesn’t even need to use the parameter, nor show anything meaningful – in practice, even a minimal or hidden sheet is enough.
Final Thought
This is one of those Tableau behaviours that isn’t obvious until you hit it.
If a parameter passed via URL isn’t applying and everything else looks correct, check whether the dashboard actually contains a worksheet. That alone might be the issue.
