# Text

{% hint style="danger" %}
**Text** is a beta feature and may not function as expected.

Currently, you can only create text in the Text Layout task. Using it in other tasks may produce flattened and unpredictable results.This feature will progressively be available across all tasks.
{% endhint %}

***

## Relevant Use Cases

* Adding product names, descriptions, or promotional text to generated visuals
* Working with CJK (Chinese, Japanese, Korean) text requiring precise character-level control
* Producing production-ready assets within a single platform

***

## How to use

### <i class="fa-text" style="color:blue;">:text:</i> Create a New Text Layer

{% stepper %}
{% step %}

#### Select “Text Layout”

In the left task menu, select <kbd><mark style="color:$primary;">**Text Layout**<mark style="color:$primary;"></kbd>.

This opens the Text Layout workspace.

Alternatively, hover over an existing scene and select Continue from this image.
{% endstep %}

{% step %}

#### Select “T”

In the bottom toolbar, select the <i class="fa-text" style="color:$primary;">:text:</i> <kbd><mark style="color:$primary;">**Text**<mark style="color:$primary;"></kbd> tool.
{% endstep %}

{% step %}

#### Add Text to the Scene

1. Click anywhere on the scene and write your text
2. The text layer will appear in the layer list once you click outside the text area.

You can create as many text layers as you want within a scene.&#x20;

{% hint style="warning" %}
**Character Limit**

There is no hard limit on text layers per scene, but performance may degrade with very large numbers (100+) of text layers.
{% endhint %}
{% endstep %}
{% endstepper %}

### <i class="fa-message-pen" style="color:blue;">:message-pen:</i> Edit an Existing Text Layer

{% stepper %}
{% step %}

#### Select a Text Layer

Select text layers to move, resize, or modify them.

**Select a single layer:**

* Single-click on any text layer to select
* A Selection border appears around the text

**Select multiple layers:**

* Hold Shift and click each text layer
* Selection border appears around both text layers

{% hint style="info" %}
**Multi Layer Selection**

After selecting multiple layers, you will be able to: Align, Group them, and apply same text styling.
{% endhint %}
{% endstep %}

{% step %}

#### Make Edits

* **Edit your Text:** double-click a text layer to edit the text.
* **Move your Text**: click and drag to a new position.
  {% endstep %}

{% step %}

#### Finish your Edit

1. Click anywhere outside the text area to exit the editing mode.
2. Your edits are automatically saved.
   {% endstep %}
   {% endstepper %}

***

## Other text features

{% content-ref url="/pages/JMLvMYnPG1aEa8MSJzCO" %}
[Typefaces](/tools/text/typefaces.md)
{% endcontent-ref %}

{% content-ref url="/pages/uoBTVZJnlW22rGEsOeRN" %}
[Text Settings](/tools/text/text-settings.md)
{% endcontent-ref %}


---

# Agent Instructions: 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:

```
GET https://docs.theseaai.com/tools/text.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.