> ## 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.
# useRecording
> useRecording returns the state and information of a recording in progress, along with helper functions for daily-js recording methods.
Paid plans only
`useRecording(params?): Object`
Accepts optional callbacks for [recording events](/reference/daily-js/events/recording-events).
When multiple recordings are running concurrently (see [multi-instance recording](/docs/guides/features/live-streaming/multi-instance)), you can pass an `instanceId` to get per-instance state. Without `instanceId`, the hook returns aggregate state across all instances. For a list of all active instances, see [`useRecordingInstances`](/reference/daily-react/use-recording-instances).
## Parameters (optional)
An object with the following properties:
A valid UUID. When provided, returns state for a specific recording instance and filters event callbacks to only fire for that instance. See [multi-instance recording](/docs/guides/features/live-streaming/multi-instance).
Callback for the [`recording-error`](/reference/daily-js/events/recording-events#recording-error) event.
Callback for the [`recording-started`](/reference/daily-js/events/recording-events#recording-started) event.
Callback for the [`recording-stopped`](/reference/daily-js/events/recording-events#recording-stopped) event.
## Return value
An object with the following properties:
### Without `instanceId` (aggregate state)
When called without `instanceId`, the hook returns aggregate state across all recording instances. This works well for single-instance use cases — the scalar fields (`layout`, `recordingId`, etc.) reflect the only active instance. With multiple concurrent instances, these fields reflect the first active instance; use `useRecording({ instanceId })` for unambiguous per-instance access.
`true` if any instance has a [`recording-error`](/reference/daily-js/events/recording-events#recording-error). With multiple instances, use `useRecording({ instanceId })` for per-instance error state.
`true` if the local participant is recorded by any instance.
`true` if any recording instance is active.
Layout of the first active instance. With multiple instances, use `useRecording({ instanceId })` for per-instance layout.
`true` for [`local` recordings](/docs/guides/features/recording/index#local).
Recording ID of the first active instance. With multiple instances, use `useRecording({ instanceId })` for per-instance recording ID.
Start date of the first active instance. With multiple instances, use `useRecording({ instanceId })` for per-instance start date.
Starter of the first active instance. With multiple instances, use `useRecording({ instanceId })` for per-instance starter.
See `daily-js` [`startRecording()`](/reference/daily-js/instance-methods/start-recording).
See `daily-js` [`stopRecording()`](/reference/daily-js/instance-methods/stop-recording).
Recording type of the first active instance. With multiple instances, use `useRecording({ instanceId })` for per-instance type.
See `daily-js` [`updateRecording()`](/reference/daily-js/instance-methods/update-recording).
### With `instanceId` (per-instance state)
When called with `instanceId`, the hook returns state for that specific recording instance only.
`true` if this instance has a recording error.
Error message for this instance, if any.
The instance ID.
Whether the local participant is recorded by this instance.
Whether this instance is currently recording.
The [recording layout](/docs/guides/features/recording#customize-cloud-recording-layouts) for this instance.
`true` if this is a local recording.
The recording ID for this instance.
When this instance started recording.
Who started this recording instance.
See `daily-js` [`startRecording()`](/reference/daily-js/instance-methods/start-recording).
See `daily-js` [`stopRecording()`](/reference/daily-js/instance-methods/stop-recording).
The recording type for this instance.
See `daily-js` [`updateRecording()`](/reference/daily-js/instance-methods/update-recording).
## Example
### Basic usage
```jsx theme={null}
import { useRecording } from '@daily-co/daily-react';
export const UseRecordingDemo = () => {
const recording = useRecording();
return
{!recording.isRecording ? 'Not' : ''} recording
;
};
```
### Multi-instance usage
```jsx theme={null}
import { useRecording } from '@daily-co/daily-react';
import { useRecordingInstances } from '@daily-co/daily-react';
// instanceId must be a valid UUID
const PORTRAIT_INSTANCE = 'a1b2c3d4-5678-9abc-def0-1234567890ab';
const LANDSCAPE_INSTANCE = 'b2c3d4e5-6789-abcd-ef01-234567890abc';
export const MultiRecordingDemo = () => {
// Aggregate state: true if any instance is recording
const { isRecording } = useRecording();
// Per-instance state
const portraitRecording = useRecording({
instanceId: PORTRAIT_INSTANCE,
});
const landscapeRecording = useRecording({
instanceId: LANDSCAPE_INSTANCE,
});
return (
Any recording active: {isRecording ? 'Yes' : 'No'}