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

# newRankingFilter()

- Package: [@gooddata/sdk-model](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/index.md)
- Kind: function
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-model/src/execution/filter/factory.ts

Creates a new ranking filter.

**Signature:**

```typescript
export declare function newRankingFilter(measureOrRef: IMeasure | ObjRefInScope | string, operator: RankingFilterOperator, value: number): IRankingFilter;
```

## Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| measureOrRef | [IMeasure](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imeasure/index.md) \| [ObjRefInScope](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objrefinscope/index.md) \| string | instance of measure to filter, or reference of the measure object; if instance of measure is provided, then it is assumed this measure is in scope of execution and will be referenced by the filter by its local identifier |
| operator | [RankingFilterOperator](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.rankingfilteroperator/index.md) | TOP or BOTTOM operator to use in the filter |
| value | number | Number of values to use in filter |

**Returns:**

[IRankingFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.irankingfilter/index.md)