> ## Documentation Index
> Fetch the complete documentation index at: https://docs.release0.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to use the Text Input element

> Collect text-based responses from users with support for short text, long-form answers, and additional input types like password, file attachments, and audio recordings. This guide covers configuration options and use cases for effective user input collection.

The **Text** User Input element enables you to collect text-based responses from your users. It offers flexibility to handle different types of text inputs and additional functionalities like file attachments and audio recordings.

<Frame style={{ maxWidth: '600px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/BMYN_fruDBtiWNDa/images/elements/inputs/text-input.png?fit=max&auto=format&n=BMYN_fruDBtiWNDa&q=85&s=66dfdbe0d85f809c359e37a6a06e8869" alt="Release0.com - Agent embed elements" width="1204" height="874" data-path="images/elements/inputs/text-input.png" />
</Frame>

## Key Features

### Short Text Input

* **Default Behavior**: The element is configured to expect short text answers by default.
* **Use Case**: Suitable for concise responses, such as names, email addresses, or brief feedback.

### Long Text Input

* **Configuration**: Enable long text input in the element's settings.
* **Use Case**: Ideal for detailed responses, such as descriptions, opinions, or open-ended questions.

### Password Type Input

* **Purpose**: Allows users to enter sensitive information securely, such as passwords. The text entered is masked (e.g., shown as dots) to protect user privacy.
* **Configuration**: Set the input type to "password" in the element settings.
* **Use Case**: Useful for scenarios where users need to provide confidential information, like account credentials or secure notes.

<Frame style={{ maxWidth: '600px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/BMYN_fruDBtiWNDa/images/elements/inputs/password-type.png?fit=max&auto=format&n=BMYN_fruDBtiWNDa&q=85&s=f6641f5397b14cff7b7f9a491cc9ac51" alt="Release0.com - Password type" width="1260" height="958" data-path="images/elements/inputs/password-type.png" />
</Frame>

> **Note**: When using the password input type (or any other input types), you can define the variable in a way that it will not be stored in the results table, ensuring that sensitive information is not exposed. In order to do this just start the **variable name** with **secure\_**. Any variables that start with this prefix will not be stored in the results table. For example `secure_password` will not be stored in the results table, but you can still use it in your flow logic.

### Allow Attachments

* **Purpose**: Lets users attach files (e.g., documents, images) to their responses.
* **How It Works**:
  * Attachments are uploaded, and a URL is generated for each file.
  * The URL is stored in the variable defined in the element configuration.
* **Use Case**: Useful for collecting supporting documents or images.

<Frame style={{ maxWidth: '600px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/BMYN_fruDBtiWNDa/images/elements/inputs/allow-upload.png?fit=max&auto=format&n=BMYN_fruDBtiWNDa&q=85&s=94e44972ddb2f49cb451aa123a5a1808" alt="Release0.com - Allow Upload File element" width="639" height="587" data-path="images/elements/inputs/allow-upload.png" />
</Frame>

<Frame style={{ maxWidth: '600px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/BMYN_fruDBtiWNDa/images/elements/inputs/file-uploaded-sample.png?fit=max&auto=format&n=BMYN_fruDBtiWNDa&q=85&s=48aef36bd69ba9c21b6985403e85d250" alt="Release0.com - Uploaded File Preview" width="799" height="264" data-path="images/elements/inputs/file-uploaded-sample.png" />
</Frame>

> **Note**: For this method to work make sure you add a **variable** in the **Save the URLs in a variable** option.

#### Allow Audio Clips

* **Purpose**: Adds a microphone button to the input field for users to record and send voice messages.
* **File Format**:
  * The recorded file is a WebM file if supported.
  * If not (e.g., Safari), the file is in MP4 format.
* **Use Case**: Perfect for scenarios where users prefer or need to respond via audio.

#### Example Use Cases

1. **Short Text Input**:
   * "What is your name?"
   * "Enter your email address."

2. **Long Text Input**:
   * "Describe your experience with our product."
   * "Provide any additional details about your request."

3. **Password Input**:
   * "Please enter your account password."
   * "Set a new password for your account."

4. **Attachments**:
   * "Please upload a copy of your resume."
   * "Attach a photo of the issue."

5. **Audio Clips**:
   * "Record and send us your feedback."
   * "Describe the problem using voice notes."

## Considerations

* **Testing**: Ensure the element is configured correctly for the desired input type.
* **Compatibility**: Confirm that attachment uploads and audio recordings are supported across user devices and browsers.
* **Variable Storage**: Define and verify the variable for storing URLs of attachments or audio files.

By configuring the Text User Input element appropriately, you can gather a wide variety of responses from your users effectively.
