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

# IMeasureValueFilterCommonProps

- Package: [@gooddata/sdk-ui-filters](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/index.md)
- Kind: interface
- Stability: beta
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-ui-filters/src/MeasureValueFilter/typings.ts

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
export interface IMeasureValueFilterCommonProps extends IMeasureValueFilterCustomComponentProps 
```
**Extends:** [IMeasureValueFilterCustomComponentProps](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercustomcomponentprops/index.md)

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [alignPoints?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsalignpoints) |  | IAlignPoint[] | **_(BETA)_** _(Optional)_ Optional alignment points for the dropdown overlay. |
| [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)[] | **_(BETA)_** _(Optional)_ Catalog items available for dimensionality |
| [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)[] | **_(BETA)_** _(Optional)_ |
| [displayTreatNullAsZeroOption?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsdisplaytreatnullaszerooption) |  | boolean | **_(BETA)_** _(Optional)_ |
| [enableMultipleConditions?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsenablemultipleconditions) |  | boolean | **_(BETA)_** _(Optional)_ 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. |
| [enableOperatorSelection?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsenableoperatorselection) |  | boolean | **_(BETA)_** _(Optional)_ |
| [enableRankingWithMvf?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsenablerankingwithmvf) |  | boolean | **_(BETA)_** _(Optional)_ Enables using ranking filters together with measure value filters (MVF). |
| [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) | **_(BETA)_** _(Optional)_ |
| [format?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsformat) |  | string | **_(BETA)_** _(Optional)_ 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. |
| [fullscreenOnMobile?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsfullscreenonmobile) |  | boolean | **_(BETA)_** _(Optional)_ When `true`, the dropdown takes the entire screen on mobile devices. |
| [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)[] | **_(BETA)_** _(Optional)_ |
| [isDimensionalityEnabled?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsisdimensionalityenabled) |  | boolean | **_(BETA)_** _(Optional)_ |
| [isFilterSummaryEnabled?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsisfiltersummaryenabled) |  | boolean | **_(BETA)_** _(Optional)_ Controls visibility of the textual filter summary shown above the dropdown footer. Defaults to `true`. |
| [isHeaderEnabled?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsisheaderenabled) |  | boolean | **_(BETA)_** _(Optional)_ 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`. |
| [isLoadingCatalogDimensionality?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsisloadingcatalogdimensionality) |  | boolean | **_(BETA)_** _(Optional)_ Whether catalog dimensionality is currently being loaded. If true, the attribute picker can show a small loading indicator. |
| [isViewMode?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsisviewmode) |  | boolean | **_(BETA)_** _(Optional)_ 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. |
| [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)[]> | **_(BETA)_** _(Optional)_ 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. |
| [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> | **_(BETA)_** _(Optional)_ Loader for the metric details shown in the dropdown header tooltip. |
| [locale?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropslocale) |  | string | **_(BETA)_** _(Optional)_ |
| [measureIdentifier](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsmeasureidentifier) |  | string | **_(BETA)_** |
| [measureTitle?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsmeasuretitle) |  | string | **_(BETA)_** _(Optional)_ Human-readable measure title used in UI texts (e.g., preview). If not provided, the preview falls back to showing only operator/value parts. |
| [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 | **_(BETA)_** |
| [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 | **_(BETA)_** _(Optional)_ Optional change callback used in [IMeasureValueFilterCommonProps.withoutApply](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropswithoutapply) 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. |
| [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 | **_(BETA)_** _(Optional)_ Callback triggered when dimensionality changes. Used to revalidate catalog items after selection changes. |
| [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) | **_(BETA)_** _(Optional)_ |
| [showSimplifiedSummary?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsshowsimplifiedsummary) |  | boolean | **_(BETA)_** _(Optional)_ 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`. |
| [treatNullAsZeroDefaultValue?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropstreatnullaszerodefaultvalue) |  | boolean | **_(BETA)_** _(Optional)_ |
| [usePercentage?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsusepercentage) |  | boolean | **_(BETA)_** _(Optional)_ |
| [useShortFormat?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsuseshortformat) |  | boolean | **_(BETA)_** _(Optional)_ 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. |
| [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) | **_(BETA)_** _(Optional)_ |
| [withoutApply?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropswithoutapply) |  | boolean | **_(BETA)_** _(Optional)_ When `true`, the dropdown hides its default Apply/Cancel footer and propagates intermediate filter state through [IMeasureValueFilterCommonProps.onChange](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsonchange) 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. |

## Property details

### IMeasureValueFilterCommonProps.alignPoints

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Optional alignment points for the dropdown overlay.

**Signature:**

```typescript
alignPoints?: IAlignPoint[];
```

#### Remarks

Mirrors the attribute filter alignment hook so hosts can position the MVF dropdown differently in nested surfaces, for example inside a dashboard filter group.

### IMeasureValueFilterCommonProps.catalogDimensionality

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Catalog items available for dimensionality

**Signature:**

```typescript
catalogDimensionality?: IDimensionalityItem[];
```

### IMeasureValueFilterCommonProps.dimensionality

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
dimensionality?: IDimensionalityItem[];
```

### IMeasureValueFilterCommonProps.displayTreatNullAsZeroOption

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
displayTreatNullAsZeroOption?: boolean;
```

### IMeasureValueFilterCommonProps.enableMultipleConditions

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

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.

**Signature:**

```typescript
enableMultipleConditions?: boolean;
```

### IMeasureValueFilterCommonProps.enableOperatorSelection

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
enableOperatorSelection?: boolean;
```

### IMeasureValueFilterCommonProps.enableRankingWithMvf

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Enables using ranking filters together with measure value filters (MVF).

**Signature:**

```typescript
enableRankingWithMvf?: boolean;
```

### IMeasureValueFilterCommonProps.filter

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
filter?: IMeasureValueFilter;
```

### IMeasureValueFilterCommonProps.format

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

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.

**Signature:**

```typescript
format?: string;
```

### IMeasureValueFilterCommonProps.fullscreenOnMobile

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

When `true`, the dropdown takes the entire screen on mobile devices.

**Signature:**

```typescript
fullscreenOnMobile?: boolean;
```

#### Remarks

Hosts that render the MVF inside responsive surfaces (e.g. dashboards) opt in to switch the overlay to a full-screen presentation on mobile viewports.

Defaults to `false`.

### IMeasureValueFilterCommonProps.insightDimensionality

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
insightDimensionality?: IDimensionalityItem[];
```

### IMeasureValueFilterCommonProps.isDimensionalityEnabled

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
isDimensionalityEnabled?: boolean;
```

### IMeasureValueFilterCommonProps.isFilterSummaryEnabled

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Controls visibility of the textual filter summary shown above the dropdown footer.

Defaults to `true`.

**Signature:**

```typescript
isFilterSummaryEnabled?: boolean;
```

### IMeasureValueFilterCommonProps.isHeaderEnabled

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

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`.

**Signature:**

```typescript
isHeaderEnabled?: boolean;
```

### IMeasureValueFilterCommonProps.isLoadingCatalogDimensionality

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Whether catalog dimensionality is currently being loaded. If true, the attribute picker can show a small loading indicator.

**Signature:**

```typescript
isLoadingCatalogDimensionality?: boolean;
```

### IMeasureValueFilterCommonProps.isViewMode

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

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.

**Signature:**

```typescript
isViewMode?: boolean;
```

### IMeasureValueFilterCommonProps.loadCatalogDimensionality

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

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.

**Signature:**

```typescript
loadCatalogDimensionality?: (dimensionality: ObjRefInScope[]) => Promise<IDimensionalityItem[]>;
```

### IMeasureValueFilterCommonProps.loadMetricDetails

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Loader for the metric details shown in the dropdown header tooltip.

**Signature:**

```typescript
loadMetricDetails?: () => Promise<IMeasureMetadataObject | undefined>;
```

#### Remarks

Invoked the first time the user opens the tooltip — never on initial render. Pass this only when you want the dropdown header to expose a question-mark icon with lazily loaded metric metadata (description, format, identifier).

### IMeasureValueFilterCommonProps.locale

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
locale?: string;
```

### IMeasureValueFilterCommonProps.measureIdentifier

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
measureIdentifier: string;
```

### IMeasureValueFilterCommonProps.measureTitle

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Human-readable measure title used in UI texts (e.g., preview). If not provided, the preview falls back to showing only operator/value parts.

**Signature:**

```typescript
measureTitle?: string;
```

### IMeasureValueFilterCommonProps.onApply

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
onApply: (filter: IMeasureValueFilter | null) => void;
```

### IMeasureValueFilterCommonProps.onChange

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Optional change callback used in [IMeasureValueFilterCommonProps.withoutApply](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropswithoutapply) 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.

**Signature:**

```typescript
onChange?: (filter: IMeasureValueFilter | null) => void;
```

### IMeasureValueFilterCommonProps.onDimensionalityChange

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Callback triggered when dimensionality changes. Used to revalidate catalog items after selection changes.

**Signature:**

```typescript
onDimensionalityChange?: (dimensionality: ObjRefInScope[]) => void;
```

### IMeasureValueFilterCommonProps.separators

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
separators?: ISeparators;
```

### IMeasureValueFilterCommonProps.showSimplifiedSummary

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

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`.

**Signature:**

```typescript
showSimplifiedSummary?: boolean;
```

### IMeasureValueFilterCommonProps.treatNullAsZeroDefaultValue

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
treatNullAsZeroDefaultValue?: boolean;
```

### IMeasureValueFilterCommonProps.usePercentage

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
usePercentage?: boolean;
```

### IMeasureValueFilterCommonProps.useShortFormat

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

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.

**Signature:**

```typescript
useShortFormat?: boolean;
```

### IMeasureValueFilterCommonProps.warningMessage

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
warningMessage?: WarningMessage;
```

### IMeasureValueFilterCommonProps.withoutApply

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

When `true`, the dropdown hides its default Apply/Cancel footer and propagates intermediate filter state through [IMeasureValueFilterCommonProps.onChange](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefiltercommonprops/index.md#imeasurevaluefiltercommonpropsonchange) 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.

**Signature:**

```typescript
withoutApply?: boolean;
```