# useName

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

Reads a name's state: owner, manager, expiry, resolver, registry and wrapper status. Signature, options, result and examples for useName in @ensforge/react.

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

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

Reads a name's state: owner, manager, expiry, resolver, registry and wrapper status. Preset of `useRead(Actions.name.get, …)`.

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

## Signature [#signature]

```ts
function useName(options: Actions.name.get.Options | undefined, config?: ReadConfig): ReadResult<Actions.name.get.ReturnType, Actions.name.get.ErrorType>
```

## Examples [#examples]

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

function View() {
  const { data } = useName({ name: "nick.eth" })
  return <span>{data?.owner}</span>
}
```

## See also [#see-also]

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