> For the complete documentation index, see [llms.txt](https://docs.agenticflow.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.agenticflow.ai/workflows/workflow-inputs/long-text-input.md).

# Long Text Input

A **Long Text Input** is an input control that provides a larger text area, allowing a user to enter multiple lines or paragraphs of text when they run a workflow.

## When to Use

This control is ideal for longer pieces of content, such as:

* An email body
* An article or blog post
* A transcript
* Detailed feedback or instructions

## How to Add

1. From your workflow's **Build** page, click on **+ Add Input**.
2. Select **Long Text Input** from the list of available controls.

## Configuration

* **Title:** The main label for the input field.
* **Description:** Optional helper text to provide more context.
* **Variable Name:** The name used to access this input's value within the workflow.
* **Optional/Required:** A toggle to specify if the user must provide this input.

## Setting a Default Value

You can pre-fill the Long Text Input with a default value:

1. Enter the desired default text into the text area.
2. Click the settings icon (⚙️) at the bottom right of the control.
3. Select **Set Current Value as Default**.

## Accessing the Value

You access the value using its variable name in double curly braces `{{}}`. For example, if the variable name is `customer_feedback`:

* **In most nodes:** Use `{{customer_feedback}}`.
* **In a Code Node (Python):** Access as a variable, e.g., `feedback = "{{customer_feedback}}"`
* **In a JavaScript step:** Access via `params.customer_feedback`.

### Example

If you create a **Long Text Input** with the variable name `article_text`, you could use it in a downstream OpenAI node to summarize the content:

```
Please provide a three-sentence summary of the following article:

{{article_text}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.agenticflow.ai/workflows/workflow-inputs/long-text-input.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.