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

# drillDown()

- Package: [@gooddata/sdk-ui-dashboard](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/index.md)
- Kind: function
- Stability: alpha
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-ui-dashboard/src/model/commands/drill.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).
> 

Creates the [IDrillDown](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idrilldown/index.md) command. Dispatching this command will result into applying drill down definition to the provided insight (result of the drill down application depends on the particular visualization type) and dispatching [IDashboardDrillDownResolved](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idashboarddrilldownresolved/index.md) event that will contain it.

In the default dashboard implementation dispatching this command will also result into opening drill dialog with the insight that has this particular drill down definition applied.

**Signature:**

```typescript
export declare function drillDown(insight: IInsight, drillDefinition: IDrillDownDefinition, drillEvent: IDashboardDrillEvent, correlationId?: string): IDrillDown;
```

## Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| insight | [IInsight](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iinsight/index.md) | insight to which the drill down should be applied. |
| drillDefinition | [IDrillDownDefinition](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idrilldowndefinition/index.md) | drill definition to apply. |
| drillEvent | [IDashboardDrillEvent](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idashboarddrillevent/index.md) | original drill event, that triggered this particular drill interaction. |
| correlationId | string | _(Optional)_ specify correlation id. It will be included in all events that will be emitted during the command processing. |

**Returns:**

[IDrillDown](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idrilldown/index.md)

drill down command