# Dashboards

Dashboards let you build a custom overview of your freispace data. Each dashboard is made up of one or more **widgets**, and every widget is powered by a query written in [Kusto Query Language (KQL)](https://learn.microsoft.com/en-us/kusto/query/?view=microsoft-fabric).

For a walkthrough of the dashboard editor itself (creating a dashboard, adding widgets, arranging your layout), see the [user guide on Dashboards](https://docs.freispace.com/user-guides/analytics/dashboards.md).

This section documents the technical side: the query language, the tables you can query, and how query results turn into widgets.

## How widgets work[​](#how-widgets-work "Direct link to How widgets work")

1. You write a KQL query against one of the [queryable entities](https://docs.freispace.com/docs/dashboards/kql-reference.md#queryable-entities).

2. freispace runs the query against your team's data.

3. The result is rendered using the **visualization type** you choose for the widget:

   <!-- -->

   * Table
   * Number / KPI
   * Bar chart
   * Line chart
   * Donut chart

The same query can usually be rendered as different visualization types — for example, a query that returns a single aggregated value works well as a Number/KPI widget, while a query grouped by a category (e.g. by client or by month) is a good fit for a bar, line or donut chart.

## Learn KQL[​](#learn-kql "Direct link to Learn KQL")

* [KQL reference for freispace](https://docs.freispace.com/docs/dashboards/kql-reference.md) — available tables, supported syntax, and example queries.
* [Microsoft's official KQL documentation](https://learn.microsoft.com/en-us/kusto/query/?view=microsoft-fabric) — the full language reference, since freispace supports the complete Kusto Query Language.