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

# IDashboardMeasureValueFilterProps

- Package: [@gooddata/sdk-ui-dashboard](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/index.md)
- Kind: interface
- Stability: alpha
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-ui-dashboard/src/presentation/filterBar/measureValueFilter/types.ts

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

**Signature:**

```typescript
export interface IDashboardMeasureValueFilterProps 
```

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [autoOpen?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idashboardmeasurevaluefilterprops/index.md#idashboardmeasurevaluefilterpropsautoopen) |  | boolean | **_(ALPHA)_** _(Optional)_ Whether the dropdown should automatically open on mount. Used to focus newly added filters. |
| [filter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idashboardmeasurevaluefilterprops/index.md#idashboardmeasurevaluefilterpropsfilter) |  | [IDashboardMeasureValueFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.idashboardmeasurevaluefilter/index.md) | **_(ALPHA)_** Definition of the dashboard measure value filter to render. Always reflects the applied filter — if/when "Apply together" mode for MVF is added, the working state is meant to be resolved internally via dashboard selectors rather than threaded through props. |
| [filterIndex](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idashboardmeasurevaluefilterprops/index.md#idashboardmeasurevaluefilterpropsfilterindex) |  | number | **_(ALPHA)_** Index of the filter among the other dashboard filters. |
| [MeasureValueFilterComponent?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idashboardmeasurevaluefilterprops/index.md#idashboardmeasurevaluefilterpropsmeasurevaluefiltercomponent) |  | ComponentType<[IMeasureValueFilterProps](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-filters/sdk-ui-filters.imeasurevaluefilterprops/index.md)> | **_(ALPHA)_** _(Optional)_ Optional custom measure value filter component to change or extend the default rendered one. |
| [onMeasureValueFilterChanged](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idashboardmeasurevaluefilterprops/index.md#idashboardmeasurevaluefilterpropsonmeasurevaluefilterchanged) |  | (filter: [IDashboardMeasureValueFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.idashboardmeasurevaluefilter/index.md), conditions: [MeasureValueFilterCondition](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.measurevaluefiltercondition/index.md)[] \| undefined, isWorkingSelectionChange?: boolean) => void | **_(ALPHA)_** Callback fired when the user changes the filter's conditions. |
| [onMeasureValueFilterClose?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idashboardmeasurevaluefilterprops/index.md#idashboardmeasurevaluefilterpropsonmeasurevaluefilterclose) |  | () => void | **_(ALPHA)_** _(Optional)_ Callback fired when the filter dropdown is closed. |
| [passDropdownButton?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idashboardmeasurevaluefilterprops/index.md#idashboardmeasurevaluefilterpropspassdropdownbutton) |  | boolean | **_(ALPHA)_** _(Optional)_ Controls whether the internal dashboard dropdown button should be passed to the SDK component. When false, the SDK component can inject its own button, for example when rendered in a filter group. |
| [readonly?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idashboardmeasurevaluefilterprops/index.md#idashboardmeasurevaluefilterpropsreadonly) |  | boolean | **_(ALPHA)_** _(Optional)_ Whether the filter is rendered in read-only mode. |
| [tabId?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idashboardmeasurevaluefilterprops/index.md#idashboardmeasurevaluefilterpropstabid) |  | string | **_(ALPHA)_** _(Optional)_ Optional tab identifier to read filter config from. When provided, the visibility icon and any other tab-scoped state will be sourced from this specific tab. When undefined, the active tab's state is used. |

## Property details

### IDashboardMeasureValueFilterProps.autoOpen

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Whether the dropdown should automatically open on mount. Used to focus newly added filters.

**Signature:**

```typescript
autoOpen?: boolean;
```

### IDashboardMeasureValueFilterProps.filter

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Definition of the dashboard measure value filter to render. Always reflects the applied filter — if/when "Apply together" mode for MVF is added, the working state is meant to be resolved internally via dashboard selectors rather than threaded through props.

**Signature:**

```typescript
filter: IDashboardMeasureValueFilter;
```

### IDashboardMeasureValueFilterProps.filterIndex

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Index of the filter among the other dashboard filters.

**Signature:**

```typescript
filterIndex: number;
```

### IDashboardMeasureValueFilterProps.MeasureValueFilterComponent

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Optional custom measure value filter component to change or extend the default rendered one.

**Signature:**

```typescript
MeasureValueFilterComponent?: ComponentType<IMeasureValueFilterProps>;
```

### IDashboardMeasureValueFilterProps.onMeasureValueFilterChanged

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Callback fired when the user changes the filter's conditions.

**Signature:**

```typescript
onMeasureValueFilterChanged: (filter: IDashboardMeasureValueFilter, conditions: MeasureValueFilterCondition[] | undefined, isWorkingSelectionChange?: boolean) => void;
```

### IDashboardMeasureValueFilterProps.onMeasureValueFilterClose

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Callback fired when the filter dropdown is closed.

**Signature:**

```typescript
onMeasureValueFilterClose?: () => void;
```

### IDashboardMeasureValueFilterProps.passDropdownButton

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Controls whether the internal dashboard dropdown button should be passed to the SDK component. When false, the SDK component can inject its own button, for example when rendered in a filter group.

**Signature:**

```typescript
passDropdownButton?: boolean;
```

### IDashboardMeasureValueFilterProps.readonly

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Whether the filter is rendered in read-only mode.

**Signature:**

```typescript
readonly?: boolean;
```

### IDashboardMeasureValueFilterProps.tabId

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Optional tab identifier to read filter config from. When provided, the visibility icon and any other tab-scoped state will be sourced from this specific tab. When undefined, the active tab's state is used.

**Signature:**

```typescript
tabId?: string;
```