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

# Text

<Warning>
  **DEPRECATION NOTICE:** This entire page documents the legacy Text
  manipulation system. **For new projects:** Use <Link href="data-binding">Data Binding</Link> instead. **For existing projects:** Plan to
  migrate from direct text run manipulation to Data Binding as soon as possible.
</Warning>

For more information on designing and animating Text, please refer to the editor's text section:

<CardGroup cols={2}>
  <Card
    title="Text"
    href="/editor/text/text-overview"
    icon={
  <svg
    xmlns="http://www.w3.org/2000/svg"
    height="100%"
    fill="none"
    viewBox="0 0 16 16"
    className="size-4 text-gray-500/80 dark:text-gray-400"
    aria-hidden="true"
  >
    <path
      fill="currentColor"
      d="M7.31 7.111 2.406 5.15l4.61-1.844.328-.126a2.3 2.3 0 0 1 1.647 0l.33.126L13.93 5.15 9.024 7.112c-.55.22-1.163.22-1.712 0"
    ></path>
    <path
      stroke="currentColor"
      stroke-linecap="round"
      stroke-linejoin="round"
      d="m2.405 10.911 4.906 1.963c.55.22 1.162.22 1.712 0l4.906-1.963M2.405 8.031 7.31 9.992c.55.22 1.162.22 1.712 0l4.906-1.963M2.405 5.15 7.31 7.111c.55.22 1.162.22 1.712 0l4.906-1.962-4.61-1.844-.329-.126a2.3 2.3 0 0 0-1.647 0l-.329.126z"
    ></path>
  </svg>
}
  >
    Information on designing and animating Text
  </Card>
</CardGroup>

## Read/Update Text Runs at Runtime

<Warning>
  **⚠️ LEGACY CONTENT WARNING:** The following sections document the deprecated
  Text manipulation system. **This content is provided for legacy support
  only.** New implementations should use <Link href="data-binding">Data Binding</Link>.
</Warning>

If you intend to update a **text run** at runtime it's important to manually enter a *unique name* for the run in the editor:

<img src="https://mintcdn.com/rive/QEBBdwwFJOiq_hKR/images/runtimes/3114789e-e298-458e-8d9b-00ca71db658d.webp?fit=max&auto=format&n=QEBBdwwFJOiq_hKR&q=85&s=016fd8859f1b8906aa175d6edd0b6b65" alt="Image" width="578" height="298" data-path="images/runtimes/3114789e-e298-458e-8d9b-00ca71db658d.webp" />

And then export the name: **right-click** and select **Export name**

<img src="https://mintcdn.com/rive/QEBBdwwFJOiq_hKR/images/runtimes/b729291c-f915-4ce0-b2fa-f6d6a742141c.webp?fit=max&auto=format&n=QEBBdwwFJOiq_hKR&q=85&s=7b3b4b6b6370896ef96b01f5d9c2861e" alt="Image" width="391" height="481" data-path="images/runtimes/b729291c-f915-4ce0-b2fa-f6d6a742141c.webp" />

You can identify an exported component if it's surrounded by square brackets. This makes it possible for the run to be "discoverable" at runtime by its name. For more information, see [Exporting for Runtime](/editor/exporting/exporting-for-runtime).

<Warning>
  **If the name is not set manually in the editor the name will not be part of
  the exported *.riv* (to reduce file size).**
</Warning>

<Note>
  Text runs can also be updated on components at runtime, see [Read/Update
  Nested Text Runs at Runtime](#read-update-nested-text-runs-at-runtime) below.
</Note>

## Update Rive Text in Unity

<Note>
  A unique run name must be set in the editor to be easily discoverable at runtime. See the text runtime docs for more information.
</Note>

A text run can be updated from an artboard instance by providing the **name** and **new value**:

```json theme={null}
Artboard artboard;

....

artboard.SetTextRun("textRunName", "newValue");
```

<Note>
  **Note:** This API only updates text runs on the given artboard, and will not update text runs on component instances.
</Note>

### Nested Text Runs

For more information about updating nested text runs in Unity, [take a look at this example](/game-runtimes/unity/text#nested-text-runs).