# useText

> For the complete documentation index, see [llms.txt](https://ensforge.com/llms.txt).

Reads one text record, such as url, avatar or com.twitter. Signature, options, result and examples for useText in @ensforge/react.

Source: https://ensforge.com/docs/reference/react/use-text

<ApiMeta kind="Read hook" stability="stable" since="1.0.0" source="packages/react/src/hooks/named/reads.ts#L56" />

Reads one text record, such as `url`, `avatar` or `com.twitter`. Preset of `useRead(Actions.record.getText, …)`.

It wraps [`record.getText`](/docs/reference/sdk/record/get-text): the same options, result and errors.

## Signature [#signature]

```ts
function useText(options: Actions.record.getText.Options | undefined, config?: ReadConfig): ReadResult<Actions.record.getText.ReturnType, Actions.record.getText.ErrorType>
```

## Examples [#examples]

```tsx title="Reading in a component"
import { useText } from "@ensforge/react"

function View() {
  const { data: url } = useText({ name: "nick.eth", key: "url" })
  return <span>{url}</span>
}
```

## See also [#see-also]

- The [hook types](/docs/reference/react#types): `ReadResult`, `WriteResult` and `ReadConfig`.