---
title: Add Recipients
description: Add signers, approvers, viewers, and CC recipients to your document. Each role determines how the recipient interacts with the document.
---

import { Callout } from 'fumadocs-ui/components/callout';
import { Step, Steps } from 'fumadocs-ui/components/steps';
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';

## Add a Recipient

{/* prettier-ignore */}
<Steps>
<Step>
### Open the document editor

You can access the document editor by clicking on a document in your Documents dashboard.

If you're uploading a document, you'll be redirected to the document editor after the upload is complete automatically.

</Step>

<Step>
### Click add signer

In the Recipients section, click **+ Add Signer** to add a new recipient row.

![Recipients panel in the document editor](/document-signing/editor-upload-recipients.webp)

</Step>

<Step>
### Enter recipient details

Fill in the following information:

- **Email**: The recipient's email address (required)
- **Name**: The recipient's name (optional, but recommended for clarity)
- **Role**: What the recipient needs to do (see [Recipient Roles](/docs/concepts/recipient-roles))

</Step>
</Steps>

## Recipient Information

### Email Address

The email address is where the recipient receives their signing invitation.

Make sure it's correct - once you send the document, the invitation goes to this address and cannot be changed.

### Name

Adding a name helps recipients identify themselves when they receive the document. The name appears in:

- The signing invitation email
- The document activity log
- The completed document's signature certificate

If you leave the name blank, the email address is displayed instead.

## Assigning Roles

Each recipient needs a role that determines what actions they can take:

| Role      | What they do                                    |
| --------- | ----------------------------------------------- |
| Signer    | Must sign the document                          |
| Approver  | Must approve the document (signing is optional) |
| Viewer    | Must confirm they viewed the document           |
| Assistant | Pre-fills fields for other recipients           |
| CC        | Receives a copy after the document is completed |

For detailed information about each role, see [Recipient Roles](/docs/concepts/recipient-roles).

<Callout type="info">
  The Assistant role is only available when sequential signing is enabled.
</Callout>

## Multiple Recipients

You can add as many recipients as you need. Click **+ Add Signer** for each additional person.

Common scenarios:

<Tabs
  items={[
    'Two-party agreement',
    'Contract with witness',
    'Approval workflow',
    'Keep stakeholders informed',
  ]}
>
  <Tab value="Two-party agreement">Add yourself and the other party as signers.</Tab>
  <Tab value="Contract with witness">Add the main signer plus a viewer as witness.</Tab>
  <Tab value="Approval workflow">Add an approver first, then signers.</Tab>
  <Tab value="Keep stakeholders informed">Add CC recipients who receive the final document.</Tab>
</Tabs>

## Signing Order

By default, all recipients receive the document at the same time and can complete their actions in any order (parallel signing). You can change this to require recipients to act in a specific sequence.

### Parallel Signing (Default)

All recipients receive the document simultaneously. The document is completed when everyone finishes their required actions. Use this when:

- The order doesn't matter
- You want the fastest completion time
- Recipients are independent of each other

### Sequential Signing

Recipients receive the document one at a time, in the order you specify. Each person must complete their action before the next person is notified.

To enable sequential signing:

{/* prettier-ignore */}
<Steps>
  <Step>
    ### Enable signing order

    Toggle on **Enable signing order** in the Recipients section.

  </Step>
  <Step>
    ### Set the order for each recipient

    Assign an order number to each recipient (1, 2, 3, etc.).

  </Step>
  <Step>
    ### Use the same number for parallel steps

    Recipients with the same order number act simultaneously at that step.

  </Step>
</Steps>

<Callout type="info">
  Sequential signing is required to use the Assistant role. Assistants must act before the signers
  whose fields they pre-fill.
</Callout>

**Example workflow:**

| Order | Recipient        | Role      |
| ----- | ---------------- | --------- |
| 1     | Admin Assistant  | Assistant |
| 2     | Department Head  | Approver  |
| 3     | Contract Party A | Signer    |
| 3     | Contract Party B | Signer    |
| -     | Legal Team       | CC        |

In this example:

1. The assistant pre-fills information
2. The department head reviews and approves
3. Both contract parties sign at the same time
4. Legal receives a copy after completion

## Editing Recipients

You can modify recipient details anytime before sending the document:

- **Change email or name**: Click on the field and type the new value
- **Change role**: Select a different role from the dropdown
- **Change signing order**: Adjust the order number (if sequential signing is enabled)

<Callout type="warn">
  After sending a document, you cannot change recipients. If you need different recipients, you'll
  need to create a new document.
</Callout>

## Removing Recipients

To remove a recipient, click the delete icon (trash) next to their row. This also removes any fields assigned to that recipient.

You cannot remove recipients after the document has been sent.

---

## See Also

- [Add Fields](/docs/users/documents/add-fields) - Place signature, text, date, and other fields on your document
- [Send Documents](/docs/users/documents/send) - Send for signing and monitor progress
- [Recipient Roles](/docs/concepts/recipient-roles) - Detailed information about each role
