# usePrimaryName

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

Reads the primary name of an address, verified against its forward address. Signature, options, result and examples for usePrimaryName in @ensforge/react.

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

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

Reads the primary name of an address, verified against its forward address. Preset of `useRead(Actions.primaryName.get, …)`.

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

## Signature [#signature]

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

## Examples [#examples]

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

function View() {
  const { data: primary } = usePrimaryName({ address })
  return <span>{primary}</span>
}
```

## See also [#see-also]

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