# usePermissions

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

Reads what an account may do with a name. Signature, options, result and examples for usePermissions in @ensforge/react.

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

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

Reads what an account may do with a name. Preset of `useRead(Actions.permission.get, …)`.

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

## Signature [#signature]

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

## Examples [#examples]

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

function View() {
  const { data: permissions } = usePermissions({ name: "alice.eth", account: address })
  return <span>{String(permissions?.can.setRecords)}</span>
}
```

## See also [#see-also]

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