# Filter widget

Filters allow you to view a dashboard with only a subset of data. The filter widgets are drop-downs filled with distinct values for a field in the database. The system currently supports the following field types:

* Strings
* Enums
* Boolean
* Versions

There is a maximum limit of 1000 values.

When creating a filter, you can choose whether users can select a single value or multiple values within the same filter widget.

Filter widgets operate on a dashboard level and apply to charts in all tabs.

{% hint style="info" %}
Refer to [Managing live dashboards](/platform/user-guide/live-dashboards/managing-live-dashboards.md) documentation to add, manage and customize filter widgets.
{% endhint %}

## Filter implementation <a href="#filterwidget-filterimplementation" id="filterwidget-filterimplementation"></a>

When you select values from the drop-down menu of a filter widget, the system translates the filter into an NQL `where` clause, which it then inserts into all relevant queries in the dashboard.

### NQL query implementation of two or more filters <a href="#filterwidget-nqlqueryimplementationoftwoormorefilters" id="filterwidget-nqlqueryimplementationoftwoormorefilters"></a>

The following scenario exemplifies how the system applies to the NQL query two filters selected on the **Dashboard** page.

<figure><img src="/files/J2nFD9KinWLjxW5kGBkD" alt="FilterWidget-1703169555.png" width="760"><figcaption></figcaption></figure>

Values from different filters are combined with a logical `AND` operator.

```
...
| where device.platform == Windows and device.hardware.manufacturer = “Dell”
```

### NQL query implementation of multiple filter values <a href="#filterwidget-nqlqueryimplementationofmultiplefiltervalues" id="filterwidget-nqlqueryimplementationofmultiplefiltervalues"></a>

Following the example above, you can choose more than one manufacturer to filter the dashboard further.

<figure><img src="/files/aOmQCVuLLWk8MtHTcpxv" alt="FilterWidget-1703169764.png" width="760"><figcaption></figcaption></figure>

Multiple values from the same filter widget are combined with a logical `OR` operator.

{% code fullWidth="false" %}

```
...
| where device.hardware.manufacturer == "Hewlett-Packard" or device.hardware.manufacturer == "Dell"
```

{% endcode %}

***

RELATED TOPIC

* [KPI](/platform/user-guide/live-dashboards/widget-types/kpi.md)
* [Line chart](/platform/user-guide/live-dashboards/widget-types/line-chart.md)
* [Bar chart](/platform/user-guide/live-dashboards/widget-types/bar-chart.md)
* [Single-metric gauge chart](/platform/user-guide/live-dashboards/widget-types/single-metric-gauge-chart.md)
* [Multi-metric gauge chart](/platform/user-guide/live-dashboards/widget-types/multi-metric-gauge-chart.md)
* [Table](/platform/user-guide/live-dashboards/widget-types/table.md)
* [Heading](/platform/user-guide/live-dashboards/widget-types/heading.md)
* [Timeframe picker](/platform/user-guide/live-dashboards/widget-types/timeframe-picker.md)


---

# 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://docs.nexthink.com/platform/user-guide/live-dashboards/widget-types/filter-widget.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.