# Variables and element filtering

> **Variable filtering** lets process owners and analysts filter process instances by variable values captured during execution (for example, invoice amount, region, or outcome). Use variable filters to segment execution results, troubleshoot behavior, and analyze business outcomes — not just technical metadata.

## Filters

**Variable filtering** lets process owners and analysts filter process instances by variable values captured during execution (for example, invoice amount, region, or outcome). Use variable filters to segment execution results, troubleshoot behavior, and analyze business outcomes — not just technical metadata.

You can apply both **basic filters** (such as version and date range) and **advanced filters** (element- and variable-level filters) to refine the data shown on the Monitoring tab.

Filter the dashboard by:

* **Version:** Select the project version to visualize.
* **Date range:** Select the time period for which Maestro displays data.
* **Status:** Filter instances by status.
  * **Active instances:** Running, Paused, Faulted
  * **Inactive instances:** Cancelled, Completed

![Variables filters in Monitoring](https://dev-assets.cms.uipath.com/assets/images/maestro/maestro-variables-filters-588260-35cbde6a.webp)

* **All filters:** Open the full filter panel and see all filtering options available for the selected process.

## Configure element and variable filters

Use the **Configure filtering** option on the Monitoring tab to define advanced filters based on executed elements and process variables.

### Filter by element

Filter data to show only process instances that executed a specific BPMN element. Maestro only lists elements that at least one instance executed.

### Filter by variable

To filter by variables, configure variable filters directly from the Monitoring view.

1. From the **Monitoring** tab, select **Configure filtering**.

   ![Configure filtering button](https://dev-assets.cms.uipath.com/assets/images/maestro/maestro-configre-filtering-558005-7c121b37.webp)

2. In the dialog, select the **Variable** field and choose one or more variables from the process variable list.

   ![Variable selector dialog](https://dev-assets.cms.uipath.com/assets/images/maestro/maestro-docs-image-588245-52606e38.webp)

3. Select **Select** to open the **Variable filter builder**.

   ![Variable filter builder](https://dev-assets.cms.uipath.com/assets/images/maestro/maestro-vaiable-filer-builder-588251-39132970.webp)

4. In the Variable filter builder:
   * Add one or more variable conditions. All conditions must match.
   * Select an operator based on the variable type, such as **equals**, **contains**, **starts with**, **ends with**, **not equal**, **is null**, or **is not null**.
   * Provide the comparison value.

   ![Variable filter builder callout](https://dev-assets.cms.uipath.com/assets/images/maestro/maestro-variable-filer-builder-callout-588255-4d70ef5b.webp)

5. Save the configuration to apply the filter to the Monitoring view.

   **Result:** The variable filter is applied to the Monitoring view and remains active until removed.

:::note
* You configure variable filtering from the **Monitoring** view. Maestro does not require any canvas-level configuration to make variables available for filtering.
* The variable selector lists variables defined in the deployed process version. If a variable does not appear, verify that the correct version is selected in Monitoring.
* Element filters only list elements that at least one instance executed.
* Variable filters persist after you enable them and remain active until you remove them.
* Variable filtering applies only to instances that run after you enable the filter.
:::