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

# Recording Node

<Callout icon="phone" color="#2563EB" iconType="regular">Available for **Pearl Voice** only.</Callout>

<div className="block dark:hidden">
  <Frame>
    <div className="p-1">
      <img src="https://mintcdn.com/nlpearl/BSZMdFdUnvFjMIlB/images/dark_mode/recordingnode.svg?fit=max&auto=format&n=BSZMdFdUnvFjMIlB&q=85&s=05bd360145da3cda9945669c6f04332c" alt="Recording node cover" className="rounded-[14px]" width="1048" height="720" data-path="images/dark_mode/recordingnode.svg" />
    </div>
  </Frame>
</div>

<div className="hidden dark:block">
  <Frame>
    <div className="p-1">
      <img src="https://mintcdn.com/nlpearl/BSZMdFdUnvFjMIlB/images/dark_mode/recordingnode.svg?fit=max&auto=format&n=BSZMdFdUnvFjMIlB&q=85&s=05bd360145da3cda9945669c6f04332c" alt="Recording node cover" className="rounded-[14px]" width="1048" height="720" data-path="images/dark_mode/recordingnode.svg" />
    </div>
  </Frame>
</div>

The **Start Recording** node gives you control over when call recording begins in a Pearl Voice flow.

## What it does

Starts recording at the exact point where Pearl reaches this node in a Pearl Voice flow.

Recording is usually managed at campaign level. In most cases, calls are recorded automatically according to the **Recording** settings in your **Inbound Campaign** or **Outbound Campaign** settings.

<Warning>
  **Feature-flagged node.** Start Recording is hidden by default and is not available in every workspace or plan.
</Warning>

To add it to your flow, ask **PearlVibe** in natural language:

```text Example prompt for PearlVibe theme={null}
Add a Start Recording node after Pearl asks the caller for permission to record the call.
```

<Note>
  If Start Recording does not appear in the toolbar or add-node panel after asking PearlVibe, it is not enabled for your account.
</Note>

## When to use it

Use Start Recording when recording should begin only after a specific moment in the call:

| Use case              | Recording begins                                             |
| --------------------- | ------------------------------------------------------------ |
| **Disclosure**        | Once Pearl informs the caller the call may be recorded       |
| **Consent**           | Once the caller agrees to be recorded                        |
| **Specific branches** | Only on selected paths of the flow                           |
| **Compliance**        | When a process requires recording to begin later in the call |

## How it works

Automatic recording is configured in your **Inbound Campaign** or **Outbound Campaign** settings. When it is enabled, recording begins at the start of the call and you do not need this node.

To trigger recording from the flow instead, set it up as a conditional action:

<Steps>
  <Step title="Disable automatic recording">
    Turn off automatic recording in the relevant Inbound or Outbound Campaign settings, so recording starts only from the flow.

    <Frame>
      <img src="https://mintcdn.com/nlpearl/tNOAEithucH3VKKM/images/dark_mode/startrecordingdisabledrecordingoption.png?fit=max&auto=format&n=tNOAEithucH3VKKM&q=85&s=83a6b21083c636a5d4184d25d643137a" alt="Disable the automatic recording option in campaign settings" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/startrecordingdisabledrecordingoption.png" />
    </Frame>

    <Warning>
      Once automatic recording is disabled, any call that does not reach the Start Recording node will **not** be recorded. Make sure every path that requires a recording leads to the node.
    </Warning>
  </Step>

  <Step title="Ask for consent (optional)">
    Add a [Dialogue](/pages/dialogue) node before Start Recording to explain the recording policy and collect the caller's answer. Start Recording does not ask for permission by itself.
  </Step>

  <Step title="Route the consent path">
    Use a conditional transition to send callers who agree to the **Start Recording** node.
  </Step>

  <Step title="Place the node">
    Put **Start Recording** exactly where recording should begin. It has no configuration fields, it is an action marker inside the flow.

    <Frame>
      <img src="https://mintcdn.com/nlpearl/BSZMdFdUnvFjMIlB/images/dark_mode/recordingnodepicture2.png?fit=max&auto=format&n=BSZMdFdUnvFjMIlB&q=85&s=72c138a7d24bb2bd7ba13ff6f482101e" alt="Start Recording node placed in a Pearl Voice flow" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/recordingnodepicture2.png" />
    </Frame>
  </Step>
</Steps>

<Info>
  Recordings are always active during test calls, regardless of this node or your campaign recording settings.
</Info>
