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

# updateLiveStreaming()

> Updates the layout of an active live stream.

<Badge color="blue">Paid plans only</Badge>

`updateLiveStreaming(options)`

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

Requires the caller to be [an owner or streaming admin](/reference/rest-api/meeting-tokens/create-meeting-token#body-properties-permissions) (a participant with `'streaming'` in their `canAdmin` permission).

## Parameters

<ParamField body="layout" type="DailyLiveStreamingLayoutConfig">
  The new layout configuration. See [`DailyStreamingLayoutConfig`](/reference/daily-js/types/daily-streaming-layout-config) for all presets and options.
</ParamField>

<ParamField body="instanceId" type="string">
  The UUID of the streaming instance to update. Omit to update the default instance.
</ParamField>

## Return value

Returns `void`. Listen for [`live-streaming-updated`](/reference/daily-js/events/live-streaming-events#live-streaming-updated) to confirm the change.

## Example

```javascript theme={null}
// Switch to active-participant layout
call.updateLiveStreaming({
  layout: { preset: 'active-participant' },
});

// Update a specific instance with a custom VCS layout
call.updateLiveStreaming({
  instanceId: '00000000-0000-4000-8000-000000000000',
  layout: {
    preset: 'custom',
    composition_params: {
      mode: 'dominant',
      showTextOverlay: true,
      'text.content': 'Hello',
      'videoSettings.roundedCorners': true,
    },
  },
});
```

## See also

<CardGroup>
  <Card title="Types" icon="t" iconType="solid">
    * [DailyStreamingOptions](/reference/daily-js/types/daily-streaming-options)
    * [DailyStreamingLayoutConfig](/reference/daily-js/types/daily-streaming-layout-config)
  </Card>

  <Card title="Methods" icon="code" iconType="solid">
    * [startLiveStreaming()](/reference/daily-js/instance-methods/start-live-streaming)
    * [stopLiveStreaming()](/reference/daily-js/instance-methods/stop-live-streaming)
    * [addLiveStreamingEndpoints()](/reference/daily-js/instance-methods/add-live-streaming-endpoints)
    * [removeLiveStreamingEndpoints()](/reference/daily-js/instance-methods/remove-live-streaming-endpoints)
  </Card>

  <Card title="Events" icon="bolt" iconType="solid">
    * [Live streaming events](/reference/daily-js/events/live-streaming-events)
  </Card>

  <Card title="Guides" icon="book-open" iconType="solid">
    * [Live streaming](/docs/daily-js/features/live-streaming)
  </Card>

  <Card title="REST API" icon="server" iconType="solid">
    * [Update live streaming](/reference/rest-api/rooms/live-streaming/update)
    * [streaming-updated webhook](/reference/rest-api/webhooks/events/streaming-updated)
  </Card>
</CardGroup>