> ## Documentation Index
> Fetch the complete documentation index at: https://docs.daily.co/llms.txt
> Use this file to discover all available pages before exploring further.

# useReceiveSettings

> Convenience hook around getReceiveSettings() and updateReceiveSettings().

`useReceiveSettings(params?) : Object`

## Parameters (optional)

<ParamField body="id" type="string">
  A unique identifier for the participant, defaults to `base` to return the base `receiveSettings`.
</ParamField>

<ParamField body="onReceiveSettingsUpdated" type="Function">
  Callback for the [`receive-settings-updated`](/reference/daily-js/events/settings-events#receive-settings-updated) event.
</ParamField>

## Return value

An object with the following properties:

<ResponseField name="receiveSettings" type="Object">
  The receive settings for the participant. See `daily-js` instance method [`updateReceiveSettings()`](/reference/daily-js/instance-methods/update-receive-settings) for an overview of receive settings.
</ResponseField>

<ResponseField name="updateReceiveSettings" type="Function">
  Updates receive settings, equivalent to calling the `daily-js` [`updateReceiveSettings()`](/reference/daily-js/instance-methods/update-receive-settings) method.
</ResponseField>

<Warning>
  Any calls to `updateReceiveSettings()` before the meeting is joined will be silently ignored.
</Warning>

## Example

```jsx theme={null}
import { useReceiveSettings } from '@daily-co/daily-react';

export const UseReceiveSettingsDemo = () => {
  const receiveSettings = useReceiveSettings();

  return (
    <div>Receiving video layer {receiveSettings?.video?.layer ?? 'N/A'}</div>
  );
};
```

## See also

<CardGroup>
  <Card title="daily-js methods" icon="code" iconType="solid">
    * [getReceiveSettings()](/reference/daily-js/instance-methods/get-receive-settings)
    * [updateReceiveSettings()](/reference/daily-js/instance-methods/update-receive-settings)
  </Card>

  <Card title="Events" icon="bolt" iconType="solid">
    * [receive-settings-updated](/reference/daily-js/events/settings-events#receive-settings-updated)
  </Card>
</CardGroup>