> Documentation index: https://www.gooddata.ai/docs/gooddata-ui/llms.txt lists every page of these docs as Markdown.

# Measure value filter

> Let users edit and apply a measure value filter, configure input formatting and null handling, or render the dropdown with a custom toggle button.

API reference: [MeasureValueFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.measurevaluefilter/index.md) (variable, beta)

[`MeasureValueFilter`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.measurevaluefilter/index.md) is a dropdown that lets users create a measure value filter or edit an existing one. When a user clicks **Apply**, the `onApply` callback receives a measure value filter that you can pass to a visualization.

![MeasureValueFilter toggle button and its open dropdown with an operator picker and a value input](https://www.gooddata.ai/docs/gooddata-ui/gd-ui/mvf_combined.png)

## [Structure](https://www.gooddata.ai/docs/gooddata-ui/latest/filters/measure-value-filter/#structure)

```tsx
import "@gooddata/sdk-ui-filters/styles/css/main.css";
import { MeasureValueFilter } from "@gooddata/sdk-ui-filters";

<MeasureValueFilter
  onApply={<on-apply-callback>}
  onCancel={<on-cancel-callback>}
  filter={<filter>}
  measureIdentifier={<measure-local-identifier>}
  buttonTitle={<toggle-button-title>}
  usePercentage={<percentage-measure-boolean>}
  warningMessage={<warning-message>}
/>
```

## [Example](https://www.gooddata.ai/docs/gooddata-ui/latest/filters/measure-value-filter/#example)

The following example shows a bar chart displaying one measure sliced by one attribute. Users can filter the displayed bars with [`MeasureValueFilter`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.measurevaluefilter/index.md).

```tsx
import { useState } from "react";
import "@gooddata/sdk-ui-filters/styles/css/main.css";
import "@gooddata/sdk-ui-charts/styles/css/main.css";
import { MeasureValueFilter } from "@gooddata/sdk-ui-filters";
import { BarChart } from "@gooddata/sdk-ui-charts";
import { type IMeasureValueFilter, measureLocalId, newMeasureValueFilter } from "@gooddata/sdk-model";
import * as Md from "./catalog.js";

const measureTitle = "$ Total Sales";

export const SalesByResort = () => {
    const [filter, setFilter] = useState<IMeasureValueFilter | null>(
        newMeasureValueFilter(Md.$TotalSales, "GREATER_THAN", 0),
    );

    return (
        <div>
            <MeasureValueFilter
                onApply={setFilter}
                filter={filter ?? undefined}
                measureIdentifier={measureLocalId(Md.$TotalSales)}
                buttonTitle={measureTitle}
            />
            <BarChart
                measures={[Md.$TotalSales]}
                viewBy={[Md.LocationResort]}
                filters={filter ? [filter] : []}
            />
        </div>
    );
};
```

## [Formatting user input](https://www.gooddata.ai/docs/gooddata-ui/latest/filters/measure-value-filter/#formatting-user-input)

The `separators` prop sets the thousands separator (`,` by default) and the decimal separator (`.` by default) of the value input.

```tsx
<MeasureValueFilter
    onApply={setFilter}
    measureIdentifier={measureLocalId(Md.$TotalSales)}
    buttonTitle="$ Total Sales"
    separators={{ thousand: " ", decimal: "," }}
/>
```

## [Percentage measures](https://www.gooddata.ai/docs/gooddata-ui/latest/filters/measure-value-filter/#percentage-measures)

Set `usePercentage` to `true` to format the filtered measure as a percentage, so the dropdown accepts percentage values instead of the measure values. It defaults to `false`.

Keep `usePercentage` set to `false` when the filtered measure has `computeRatio` enabled: such a measure is filtered by its actual values, not by the percentages. See [Filter by a percentage measure](https://www.gooddata.ai/docs/gooddata-ui/latest/filters/filter-visual-components/index.md#filter-by-a-percentage-measure).

## [Warning message](https://www.gooddata.ai/docs/gooddata-ui/latest/filters/measure-value-filter/#warning-message)

`warningMessage` shows a message in the dropdown. Pass a string, or an object with `text` and `severity` (`"low"`, `"medium"`, or `"high"`), where `severity` sets the background color of the message.

## [Operator selection](https://www.gooddata.ai/docs/gooddata-ui/latest/filters/measure-value-filter/#operator-selection)

Users can pick the comparison operator in the dropdown. To hide the operator picker, set `enableOperatorSelection` to `false`. It defaults to `true`.

## [Treating null values as 0](https://www.gooddata.ai/docs/gooddata-ui/latest/filters/measure-value-filter/#treating-null-values-as-0)

By default, an execution containing a measure value filter does not pass null (missing) values to arithmetic operations.
However, you can allow users to make the execution treat the null values as 0 and include the null results in the filtering process.

To let users do so, show the "Treat blank values as 0" checkbox in the filter dialog by setting `displayTreatNullAsZeroOption` to `true`. To select the checkbox by default, set `treatNullAsZeroDefaultValue` to `true`. Both default to `false`.

![Measure value filter dialog with the Treat blank values as 0 checkbox selected](https://www.gooddata.ai/docs/gooddata-ui/gd-ui/mvf_treat_null_values_as.png)

```tsx
<MeasureValueFilter
    onApply={setFilter}
    measureIdentifier={measureLocalId(Md.$TotalSales)}
    buttonTitle="$ Total Sales"
    displayTreatNullAsZeroOption={true}
    treatNullAsZeroDefaultValue={true}
/>
```

## [Custom toggle button](https://www.gooddata.ai/docs/gooddata-ui/latest/filters/measure-value-filter/#custom-toggle-button)

To toggle the filter dropdown with your own button, use [`MeasureValueFilterDropdown`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.measurevaluefilterdropdown/index.md) (beta). It renders only the dropdown body, outside of the current DOM tree, using [portals](https://react.dev/reference/react-dom/createPortal).

![Custom toggle button with the measure value filter dropdown open below it](https://www.gooddata.ai/docs/gooddata-ui/gd-ui/mvf_custom_button.png)

[`MeasureValueFilterDropdown`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.measurevaluefilterdropdown/index.md) takes the same props as [`MeasureValueFilter`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.measurevaluefilter/index.md), with these differences:

- It has no `buttonTitle`.
- `onCancel` is required, because you use it to hide the dropdown.
- `anchorEl` (optional) sets the element the dropdown is aligned to, typically your toggle button. It takes an `HTMLElement` or a CSS selector string and defaults to `"body"`.

## [Props](https://www.gooddata.ai/docs/gooddata-ui/latest/filters/measure-value-filter/#props)

| Prop | Type | Required | Description | Inherited from |
|------|------|----------|-------------|----------------|
| [`buttonTitle`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefilterprops/index.md#imeasurevaluefilterpropsbuttontitle) | `string` | Yes | — | — |
| [`autoOpen`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefilterprops/index.md#imeasurevaluefilterpropsautoopen) | `boolean` | No | When toggled from falsy to truthy, opens the dropdown once. A re-render with the same truthy value will not re-open it after the user has dismissed it. | — |
| [`buttonDisabled`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefilterprops/index.md#imeasurevaluefilterpropsbuttondisabled) | `boolean` | No | — | — |
| [`buttonSubtitle`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefilterprops/index.md#imeasurevaluefilterpropsbuttonsubtitle) | `string` | No | — | — |
| [`buttonTitleExtension`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefilterprops/index.md#imeasurevaluefilterpropsbuttontitleextension) | `ReactNode` | No | — | — |
| [`onCancel`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefilterprops/index.md#imeasurevaluefilterpropsoncancel) | `() => void` | No | — | — |
| [`measureIdentifier`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsmeasureidentifier) | `string` | Yes | — | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`onApply`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsonapply) | `(filter:` [`IMeasureValueFilter`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imeasurevaluefilter/index.md) `\| null) => void` | Yes | — | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`alignPoints`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsalignpoints) | `IAlignPoint[]` | No | Optional alignment points for the dropdown overlay. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`BodyComponent`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercustomcomponentprops/index.md#imeasurevaluefiltercustomcomponentpropsbodycomponent) | `ComponentType<`[`IMeasureValueFilterBodyProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefilterbodyprops/index.md)`>` | No | Customize the dropdown body — the area between the header and the actions footer. | [`IMeasureValueFilterCustomComponentProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercustomcomponentprops/index.md) |
| [`catalogDimensionality`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropscatalogdimensionality) | [`IDimensionalityItem`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.idimensionalityitem/index.md)`[]` | No | Catalog items available for dimensionality | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`dimensionality`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsdimensionality) | [`IDimensionalityItem`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.idimensionalityitem/index.md)`[]` | No | — | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`displayTreatNullAsZeroOption`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsdisplaytreatnullaszerooption) | `boolean` | No | — | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`DropdownActionsComponent`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercustomcomponentprops/index.md#imeasurevaluefiltercustomcomponentpropsdropdownactionscomponent) | `ComponentType<`[`IMeasureValueFilterDropdownActionsProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefilterdropdownactionsprops/index.md)`>` | No | Customize the dropdown actions (footer) component. | [`IMeasureValueFilterCustomComponentProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercustomcomponentprops/index.md) |
| [`DropdownButtonComponent`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercustomcomponentsprops/index.md#imeasurevaluefiltercustomcomponentspropsdropdownbuttoncomponent) | `ComponentType<`[`IMeasureValueFilterDropdownButtonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefilterdropdownbuttonprops/index.md)`>` | No | Customize MeasureValueFilter dropdown button (header) component. | [`IMeasureValueFilterCustomComponentsProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercustomcomponentsprops/index.md) |
| [`enableMultipleConditions`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsenablemultipleconditions) | `boolean` | No | Enables UI support for defining multiple measure value filter conditions. When set to `false` (default), only a single condition is shown/edited and, if the provided filter contains multiple conditions, only the first one is used. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`enableOperatorSelection`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsenableoperatorselection) | `boolean` | No | — | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`enableRankingWithMvf`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsenablerankingwithmvf) | `boolean` | No | Enables using ranking filters together with measure value filters (MVF). | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`filter`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsfilter) | [`IMeasureValueFilter`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imeasurevaluefilter/index.md) | No | — | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`format`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsformat) | `string` | No | Number format pattern for the measure (e.g., "#,##0.00", "$#,##0", etc.). When provided, values in the preview section will be formatted using this pattern. If not provided, falls back to simple number formatting with separators. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`fullscreenOnMobile`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsfullscreenonmobile) | `boolean` | No | When `true`, the dropdown takes the entire screen on mobile devices. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`insightDimensionality`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsinsightdimensionality) | [`IDimensionalityItem`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.idimensionalityitem/index.md)`[]` | No | — | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`isDimensionalityEnabled`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsisdimensionalityenabled) | `boolean` | No | — | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`isFilterSummaryEnabled`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsisfiltersummaryenabled) | `boolean` | No | Controls visibility of the textual filter summary shown above the dropdown footer. Defaults to `true`. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`isHeaderEnabled`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsisheaderenabled) | `boolean` | No | When true, renders a header at the top of the dropdown body with the metric title and a question-mark icon revealing metric details on hover/focus. Defaults to `false`. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`isLoadingCatalogDimensionality`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsisloadingcatalogdimensionality) | `boolean` | No | Whether catalog dimensionality is currently being loaded. If true, the attribute picker can show a small loading indicator. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`isViewMode`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsisviewmode) | `boolean` | No | When true, hides explanatory help tooltips (question marks) inside the dropdown. Intended for read-only / view-mode contexts where the educational UI is not needed. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`loadCatalogDimensionality`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsloadcatalogdimensionality) | `(dimensionality:` [`ObjRefInScope`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objrefinscope/index.md)`[]) => Promise<`[`IDimensionalityItem`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.idimensionalityitem/index.md)`[]>` | No | Callback for loading catalog dimensionality items lazily. When provided, the dimensionality picker can call this on demand (e.g. when opened) to load compatible attributes/dates for the current dimensionality. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`loadMetricDetails`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsloadmetricdetails) | `() => Promise<`[`IMeasureMetadataObject`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imeasuremetadataobject/index.md) `\| undefined>` | No | Loader for the metric details shown in the dropdown header tooltip. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`locale`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropslocale) | `string` | No | — | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`measureTitle`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsmeasuretitle) | `string` | No | Human-readable measure title used in UI texts (e.g., preview). If not provided, the preview falls back to showing only operator/value parts. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`onChange`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsonchange) | `(filter:` [`IMeasureValueFilter`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imeasurevaluefilter/index.md) `\| null) => void` | No | Optional change callback used in IMeasureValueFilterCommonProps.withoutApply mode. When `withoutApply` is `true`, every meaningful state change (operator switch, value commit, dimensionality update, treat-null-values toggle) is propagated through this callback instead of waiting for the user to click the Apply button. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`onDimensionalityChange`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsondimensionalitychange) | `(dimensionality:` [`ObjRefInScope`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objrefinscope/index.md)`[]) => void` | No | Callback triggered when dimensionality changes. Used to revalidate catalog items after selection changes. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`separators`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsseparators) | [`ISeparators`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iseparators/index.md) | No | — | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`showSimplifiedSummary`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsshowsimplifiedsummary) | `boolean` | No | When true, renders a simplified filter summary: the "Preview:" header and the metric title are omitted, so only the conditions (and dimensionality, if any) are shown. Defaults to `false`. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`treatNullAsZeroDefaultValue`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropstreatnullaszerodefaultvalue) | `boolean` | No | — | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`usePercentage`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsusepercentage) | `boolean` | No | — | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`useShortFormat`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsuseshortformat) | `boolean` | No | When true, uses K/M/B shortening for compact display in the preview (e.g., "1K" instead of "1,000"). When false or undefined, uses full metric format. This provides consistency between the filter button and preview display. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`warningMessage`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropswarningmessage) | [`WarningMessage`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.warningmessage/index.md) | No | — | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |
| [`withoutApply`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropswithoutapply) | `boolean` | No | When `true`, the dropdown hides its default Apply/Cancel footer and propagates intermediate filter state through IMeasureValueFilterCommonProps.onChange instead of accumulating changes until the user clicks Apply. Intended for hosts (such as the Dashboard "Apply together" mode) that collect working filter changes and apply them via a global Apply action. | [`IMeasureValueFilterCommonProps`](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md) |