# External Parameters

You can send external parameters to the dashboards embedded in your application. These parameters can be sent either directly to the parameters within the report or as hidden parameters (e.g., tenantId).

## General Usage

To send parameters, you can include them in the {Params} field of the embed URL in JSON format as key-value pairs. 

For example:

Let's say we have a dashboard with a parameter called "Start Date" (the programmatic name of the parameter is `startDate`).

<figure><img src="/files/F6hHmu6rWo4ICKbZY0QS" alt=""><figcaption></figcaption></figure>

To populate this parameter externally via embedding, we need to structure the embed URL as follows:

```
{ReportqlUrl}/widget/dashboard/{Token}/d3e43302-7014-413b-87e0-9ac9e871efb9/{"startDate":"06.10.2025", "autoload": "true"}
```

## Hidden Parameters

In some cases, there may be a need to send static parameters that should not be filled in from the screen (e.g., tenantId). For such situations, you can add an "External Parameter" to the dashboard and use it. **This type of parameter is not shown to the user but is filled in the background and can be used in the queries within the dashboard.**

<figure><img src="/files/Hj1FGr34EL6vLgwLF0O4" alt=""><figcaption></figcaption></figure>

Example usage:

Let’s assume we have a row-based tenantId mechanism in a multi-tenant application. We want the dashboards in Reportql to work based on a tenantId value provided externally. For this situation:

Add an "External Parameter" named TenantId to the dashboard.

<figure><img src="/files/TyOPhkzmKqcg0wM2sCMn" alt=""><figcaption></figcaption></figure>

To populate this parameter externally via embedding, we need to structure the embed URL as follows:

```
{ReportqlUrl}/widget/dashboard/{Token}/d3e43302-7014-413b-87e0-9ac9e871efb9/{"tenantId":"3b21a189-d481-4500-896a-3fa37c81fba8"}
```

You can then use the @tenantid parameter in your queries. For example:

```
select * from orders where tenantid = @tenantid
```

<figure><img src="/files/qVVbQ1p6ic7HwBrE3GiD" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kuadron.gitbook.io/reportql/external-parameters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.