LiveKit docs › Hooks › useParticipantAttribute

---

# useParticipantAttribute

The `useParticipantAttribute` hook returns the latest value of a given attribute key of a participant. It requires a `Participant` object passed as property in the `UseParticipantAttributesOptions` or via the `ParticipantContext`.

## Import

```typescript
import { useParticipantAttribute } from "@livekit/components-react";

```

## Usage

```tsx
const myAttributeValue = useParticipantAttribute("targetAttributeName");

```

## Properties

- **`attributeKey`** _(string)_: 

- **`options.participant`** _(Participant)_ (optional): 

## Returns

```typescript
string;

```

---

This document was rendered at 2026-06-07T11:32:58.974Z.
For the latest version of this document, see [https://docs.livekit.io/reference/components/react/hook/useparticipantattribute.md](https://docs.livekit.io/reference/components/react/hook/useparticipantattribute.md).

To explore all LiveKit documentation, see [llms.txt](https://docs.livekit.io/llms.txt).