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

# useLiveStreamingInstances

> useLiveStreamingInstances returns an array of all live streaming instance states.

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

`useLiveStreamingInstances(): LiveStreamingInstanceState[]`

This is useful when working with [multi-instance live streaming](/docs/guides/features/live-streaming/multi-instance) to enumerate and display all active (and recently stopped) streaming instances.

## Return value

An array of `LiveStreamingInstanceState` objects, each with the following properties:

<ResponseField name="errorMsg" type="string">
  Error message for this instance, if any.
</ResponseField>

<ResponseField name="instanceId" type="string">
  The unique identifier for this live streaming instance.
</ResponseField>

<ResponseField name="isLiveStreaming" type="boolean">
  Whether this instance is currently live streaming.
</ResponseField>

<ResponseField name="layout" type="Object">
  The live streaming layout configuration for this instance.
</ResponseField>

## Example

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

export const StreamingInstancesList = () => {
  const instances = useLiveStreamingInstances();

  if (instances.length === 0) {
    return <div>No live streams</div>;
  }

  return (
    <ul>
      {instances.map((instance) => (
        <li key={instance.instanceId}>
          {instance.instanceId}: {instance.isLiveStreaming ? 'Live' : 'Stopped'}
          {instance.layout?.preset && ` (${instance.layout.preset})`}
        </li>
      ))}
    </ul>
  );
};
```

## See also

<CardGroup>
  <Card title="Hooks" icon="code" iconType="solid">
    * [useLiveStreaming()](/reference/daily-react/use-live-streaming)
  </Card>

  <Card title="Guides" icon="book-open" iconType="solid">
    * [Multi-instance live streaming and recording](/docs/guides/features/live-streaming/multi-instance)
  </Card>
</CardGroup>