---
description: >-
  The text input element allows you to process user inputted text on your
  dashboard.
---

# Text Input

![](https://2280154036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQY7AWezpSx_iDLogun%2Fuploads%2FFixdhIZaExV8DjfepuLe%2FFrame%204%20\(3\).png?alt=media\&token=a77b967f-3c4a-4f8c-9e54-b5d7032c5a92)

## What it does

The text input allows you to capture a users text input and configure the dashboard to respond to the inputted text.&#x20;

## Configuration

![](https://2280154036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQY7AWezpSx_iDLogun%2Fuploads%2F4WVtxe1g3OD74gcf1fYp%2FFrame%202.png?alt=media\&token=41a80c97-ddb1-4e92-8073-52970562034f)

### Basic Configuration

| Configuration Option | Description                                                                                                   |
| -------------------- | ------------------------------------------------------------------------------------------------------------- |
| Label                | This label appears above the text input and can be configured to describe how the text input should be used.  |
| Placeholder Text     | This is the message shown in the text input when no input has been written by the user yet.                   |
| Search Icon          | This icon can be toggled on if the text input is being used as a search bar.                                  |



## Variable Usage

In the SQL query, use the following syntax

```sql
--- search bar usage: If you wish to use this text input element as a search bar for, 
--- a data table, you can configure the SQL editor like this, and the user will be 
--- able to search the table based on column_1
WHERE 1=1
[[AND column_1 = {{text_input1}}]]
```
