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

# useWidgetFilters()

- Package: [@gooddata/sdk-ui-dashboard](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/index.md)
- Kind: function
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-ui-dashboard/src/model/react/useWidgetFilters.ts
- Guides: [useWidgetFilters](https://www.gooddata.ai/docs/gooddata-ui/latest/dashboard-plugins/use-widget-filters/index.md)

Hook for obtaining the effective filters for a widget.

**Signature:**

```typescript
export declare function useWidgetFilters(widget: FilterableDashboardWidget | undefined | null, insight?: IInsightDefinition): QueryProcessingState<IFilter[]>;
```

## Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| widget | [FilterableDashboardWidget](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.filterabledashboardwidget/index.md) \| undefined \| null | widget to get effective filters for |
| insight | [IInsightDefinition](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iinsightdefinition/index.md) | _(Optional)_ insight to evaluate the filters for in context of the widget |

**Returns:**

[QueryProcessingState](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.queryprocessingstate/index.md)&lt;[IFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ifilter/index.md)[]&gt;

set of filters that should be used to execute the given widget

## Remarks

The filters returned should be used with [insightSetFilters()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.insightsetfilters/index.md) to obtain insight that is ready for execution.