Apply Row-Level Filters via URL in Bold BI
Easily filter data in your Bold BI dashboards using the embed_datasource_filter parameter in the iFrame URL. This feature allows you to customize data views for users based on their roles or permissions, enabling Row-Level Security (RLS)
How It Works
- Add the
embed_datasource_filterparameter to the iFrame URL. - Use
&&for dashboard parameters and&for URL parameters. - Parameter names must match the dashboard’s column names exactly and are case-sensitive.
Examples
Filter by Dashboard Parameter
Show only data for the Sales department:
<iframe src="http://localhost:51777/bi/site/site1/dashboards/5cfde98c-d352-4863-8a93-d6679263191b/Sales/Sales%20Analysis%20Dashboard?isembed=true&embed_datasource_filter=&&Department=Sales" id="dashboard-frame" width="100%" height="100%" allowfullscreen frameborder="0"></iframe>Filter by URL Parameter
Show only data for the North region:
<iframe src="http://localhost:51777/bi/site/site1/dashboards/5cfde98c-d352-4863-8a93-d6679263191b/Sales/Sales%20Analysis%20Dashboard?isembed=true&embed_datasource_filter=&Region=North" id="dashboard-frame" width="100%" height="100%" allowfullscreen frameborder="0"></iframe>Filter by Both Dashboard and URL Parameters
Show data for the Sales department and a specific user ID:
<iframe src="http://localhost:51777/bi/site/site1/dashboards/5cfde98c-d352-4863-8a93-d6679263191b/Sales/Sales%20Analysis%20Dashboard?isembed=true&embed_datasource_filter=&&Department=Sales&UserID=123" id="dashboard-frame" width="100%" height="100%" allowfullscreen frameborder="0"></iframe>Filter Syntax Reference
Use the table below to understand how to structure the embed_datasource_filter parameter for different scenarios.
| Scenario | Filter Syntax |
|---|---|
| Dashboard Parameter Only | &embed_datasource_filter=&&Parameter=Value |
| URL Parameter Only | &embed_datasource_filter=&Parameter=Value |
| Multiple Dashboard Parameters | &embed_datasource_filter=&&Parameter=Value&&Parameter1=Value1 |
| Multiple URL Parameters | &embed_datasource_filter=&Parameter=Value&Parameter1=Value1 |
| Dashboard and URL Parameters | &embed_datasource_filter=&&Parameter=Value&Parameter1=Value1 |
Note: Ensure parameter names match your dashboard’s column names exactly, as they are case-sensitive.