> ## 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.

# getReceiveSettings()

> Returns the current media receive settings, either for all participants or a specific one.

`getReceiveSettings(id?, options?)`

<Badge color="red">{"✗"} Prebuilt</Badge> <Badge color="green">{"✓"} Custom</Badge>

Returns the current receive settings. When called with no arguments, returns the full `DailyReceiveSettings` object for all participants. When called with a participant ID, returns only that participant's settings.

<Note>
  `base` settings are not available until after [`join()`](/reference/daily-js/instance-methods/join) is called.
</Note>

## Parameters

<ParamField body="id" type="string">
  Optional. A participant session ID. When provided, returns only that participant's receive settings.
</ParamField>

<ParamField body="options.showInheritedValues" type="boolean">
  Optional. When `true`, includes inherited values from `base` in the per-participant result. Defaults to `false`.
</ParamField>

## Return value

Returns a `Promise<DailyReceiveSettings>` when called with no ID, or `Promise<DailySingleParticipantReceiveSettings>` when called with an ID.

See [`updateReceiveSettings()`](/reference/daily-js/instance-methods/update-receive-settings) for a full explanation of the receive settings structure.

## Example

```javascript theme={null}
// Get all receive settings
const settings = await call.getReceiveSettings();
// {
//   base: { video: { layer: 2 }, screenVideo: { layer: 0 } },
//   d38ed17b-1ede-4273-a1c8-cf11ccf16972: { video: { layer: 1 } }
// }

// Get a specific participant's settings (without inherited values)
const participantSettings = await call.getReceiveSettings(id);
// { video: { layer: 1 } }

// Include inherited values from base
const withInherited = await call.getReceiveSettings(id, { showInheritedValues: true });
// { video: { layer: 1 }, screenVideo: { layer: 0 } }
```

## See also

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

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

  <Card title="Guides" icon="book-open" iconType="solid">
    * [Receive-side video quality](/docs/guides/scaling-calls/best-practices-to-scale-large-experiences#adjust-receive-side-video-quality)
  </Card>
</CardGroup>