# Show Modal

**Introduction** 

This step displays a modal with a single input field as a response to a user interaction in Discord, such as a command or button press.

**Description** 

Useful for collecting a short text or a paragraph from users within a modal dialog box.

**Configuration**

1. **Interaction**: The interaction that triggers the modal. Modals can only be displayed in response to an interaction. This is required.
2. **Title**: Set the title of the modal. Length must be between 1 and 45 characters. Required.
3. **Input**: Define the input field. It includes:
   * **Style**: Choose between "Short" for a single-line input or "Paragraph" for a multi-line text area.
   * **Label**: The label for the input field. Length must be between 1 and 45 characters. Required.
   * **Placeholder**: (Optional) A placeholder text in the input field. Maximum 100 characters.
   * **Minimum Length**: (Optional) The minimum number of characters required. Up to 4000.
   * **Maximum Length**: (Optional) The maximum number of characters allowed. Up to 4000.
4. **Timeout**: Set how long to wait for user input before timing out. Range is 5000 milliseconds to 15 minutes. This dictates how long the modal waits for user interaction before continuing or stopping the automation.
5. **Fail on Timeout**: Choose whether the automation should stop if the step times out. If enabled, the automation stops on timeout; if disabled, it continues without the interaction and input value.

**Outputs**

* **Interaction**: The modal interaction object. Null in case of a timeout.
* **Input value**: The user's input in the modal. Null in case of a timeout.
* **Timeout**: Indicates whether a timeout occurred.

**Usage** 

Ideal for scenarios requiring user input, such as gathering feedback, asking questions, or collecting data in an interactive format.

**Permissions**

* No specific permissions are required for this step.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flexy.bot/modules/discord/steps/show-modal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.