---
title: "Dialog"
summary: "@slack/web-api / Dialog"
url: "https://docs.slack.dev/tools/node-slack-sdk/reference/web-api/interfaces/Dialog"
type: "guide"
---

Source: https://docs.slack.dev/tools/node-slack-sdk/reference/web-api/interfaces/Dialog

[@slack/web-api](https://docs.slack.dev/tools/node-slack-sdk/reference/web-api.md) / Dialog

# Interface: Dialog

Defined in: packages/types/dist/dialog.d.ts:5

Reusable shapes for argument values

## Deprecated {#deprecated}

Dialogs are a deprecated surface in Slack. For more details on how to upgrade, check out our [Upgrading outmoded dialogs to modals guide](https://docs.slack.dev/block-kit/upgrading-outmoded-dialogs-to-modals.md). This will be removed in the next major version.

## Properties {#properties}

### callback_id {#callback_id}

```
callback_id: string;
```

Defined in: packages/types/dist/dialog.d.ts:7

* * *

### elements {#elements}

```
elements: object[];
```

Defined in: packages/types/dist/dialog.d.ts:8

#### data_source? {#data_source}

```
optional data_source?: "channels" | "users" | "conversations" | "external";
```

#### hint? {#hint}

```
optional hint?: string;
```

#### label {#label}

```
label: string;
```

#### max_length? {#max_length}

```
optional max_length?: number;
```

#### min_length? {#min_length}

```
optional min_length?: number;
```

#### min_query_length? {#min_query_length}

```
optional min_query_length?: number;
```

#### name {#name}

```
name: string;
```

#### option_groups? {#option_groups}

```
optional option_groups?: object[];
```

#### optional? {#optional}

```
optional optional?: boolean;
```

#### options? {#options}

```
optional options?: SelectOption[];
```

#### placeholder? {#placeholder}

```
optional placeholder?: string;
```

#### selected_options? {#selected_options}

```
optional selected_options?: SelectOption[];
```

#### subtype? {#subtype}

```
optional subtype?: "number" | "url" | "email" | "tel";
```

#### type {#type}

```
type: "text" | "textarea" | "select";
```

#### value? {#value}

```
optional value?: string;
```

* * *

### notify_on_cancel? {#notify_on_cancel}

```
optional notify_on_cancel?: boolean;
```

Defined in: packages/types/dist/dialog.d.ts:29

* * *

### state? {#state}

```
optional state?: string;
```

Defined in: packages/types/dist/dialog.d.ts:30

* * *

### submit_label? {#submit_label}

```
optional submit_label?: string;
```

Defined in: packages/types/dist/dialog.d.ts:28

* * *

### title {#title}

```
title: string;
```

Defined in: packages/types/dist/dialog.d.ts:6