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

# TextInput

### Attributes

<ParamField path="id" type="str">
  The identifier used to retrieve the widget value from the settings.
</ParamField>

<ParamField path="label" type="str">
  The label of the input widget.
</ParamField>

<ParamField path="initial" type="str" optional>
  The initial value of the input widget.
</ParamField>

<ParamField path="placeholder" type="str" optional>
  The placeholder value of the input widget.
</ParamField>

<ParamField path="tooltip" type="str" optional>
  The tooltip text shown when hovering over the tooltip icon next to the label.
</ParamField>

<ParamField path="description" type="str" optional>
  The text displayed underneath the input widget.
</ParamField>

### Usage

```python Code Example theme={null}
import chainlit as cl
from chainlit.input_widget import TextInput


@cl.on_chat_start
async def start():
    settings = await cl.ChatSettings(
        [
            TextInput(id="AgentName", label="Agent Name", initial="AI"),
        ]
    ).send()
    value = settings["AgentName"]

```