> ## Documentation Index
> Fetch the complete documentation index at: https://relevanceai-docs-tsp-1431.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Text input

> Input a line of text

## What is a Text input

Text input is an input component that allows you to enter a line of text.
The value can be entered by the user or later fetched from an uploaded dataset (bulk-run).

## When to use the Text input component

The Text input component is suitable for short pieces of text. Such as a question, name, topic, etc.

## How to add a Text input to my custom Tool

The Text input component is listed under User inputs. You can add it to your Tool using the main section
or the side-bar.

<img src="https://mintcdn.com/relevanceai-docs-tsp-1431/RAcOraLBzkI1hNxr/images/build-custom-tools/user-input/text-input-1.png?fit=max&auto=format&n=RAcOraLBzkI1hNxr&q=85&s=3d766a0698185b7ed636caac48f409b4" alt="Text inputs" width="3052" height="1814" data-path="images/build-custom-tools/user-input/text-input-1.png" />

## Text input setting

<Snippet file="components/inputs/general-input-setting.mdx" />

<Snippet file="components/inputs/default-value-tip.mdx" />

## Fill automatically from the run

Text inputs support automatic filling with information about the user who triggered the agent run. Select one of the auto-fill options and the server resolves the user's identity at run time, injecting the value directly into the tool's parameters without the AI providing or seeing it.

Open the **Fill automatically from the run** dropdown on any text input. The two available options are **Triggering user's email** (the verified email address of the human who started the run) and **Triggering user's name** (the display name of the human who started the run).

<Note>
  These values are resolved and injected server-side. They are hidden from the AI and cannot be spoofed or overridden by the model.
</Note>

<Warning>
  Scheduled runs, webhook triggers, and embed triggers have no associated user. Auto-fill inputs remain empty for non-human triggers. If an auto-fill input is marked as required and the run is triggered without a human user, the run will be rejected.
</Warning>

### Use cases

<CardGroup cols={2}>
  <Card title="Logging" icon="list">
    Record which user performed which action in your tool outputs or connected systems.
  </Card>

  <Card title="Personalization" icon="user">
    Customize tool responses or outputs based on the identity of the person running it.
  </Card>

  <Card title="Audit trails" icon="shield-check">
    Maintain records of who triggered specific operations for compliance or review.
  </Card>

  <Card title="Security" icon="lock">
    Tie actions to verified user identities without relying on user-supplied values.
  </Card>
</CardGroup>

## Access the entered text

To access the entered text use the variable mode `{{}}` and the input step name. Under the default setting it is accessible
via `{{text}}` (or `params.text` in  a JavaScript step).