# Placeholders on Emails

## Overview

Rechat has the ability to send two kind of emails:

* Marketing Emails
* Transactional Emails

If you send a marketing email to 10 people,  and use `Hi {{recipient.first_name}}` , each of the recipients will receive a personalized email with their name:

```
┌──────────────────┐      ┌──────────────────┐      ┌──────────────────┐
│  Hi Jane,        │      │  Hi John,        │      │  Hi Sarah,       │
└──────────────────┘      └──────────────────┘      └──────────────────┘
         ↓                         ↓                         ↓
jane.doe@example.com    john.doe@example.com    sarah@example.com
```

However, when you send a transactional email, you are sending 1 single email, with the same copy, to 10 different email addresses. Email protocol doesn't allow one email, sent to different recipients, to have different content.

```
┌─────────────────────────────────┐
│   Hi Jane,                      │
└─────────────────────────────────┘
         │
         ├──────→ jane.doe@example.com
         ├──────→ john.doe@example.com
         └──────→ sarah@example.com
```

If we wanted to allow full placeholder capability on transactional emails, we essentially would've had to disable sending an email to multiple recipients (Multiple `to`, `cc`), because they all require the same email to be sent to multiple people.

#### How do I know what type of email I'm sending?

When sending your email, if you see the option to use `To` or `Cc`, that means it's going to be a transactional email.

<figure><img src="https://1031368632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJZySovZjoLVT1XAonI%2Fuploads%2FxIBqB0mZSi4dlayzy9QJ%2FScreenshot%202025-12-01%20at%207.37.29%E2%80%AFPM.png?alt=media&#x26;token=b46c4644-d919-4ae7-b362-9511994ad1e2" alt="" width="375"><figcaption><p>Transactional email</p></figcaption></figure>

However, if you don't have the option to use `Cc` and all recipients are `Locked in` as `bcc`, that effectively means you are sending a marketing email, which means we'll be sending multiple emails (one per recipient), but full placeholder functionality will work as expected.

<figure><img src="https://1031368632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJZySovZjoLVT1XAonI%2Fuploads%2FpXFyYVD7AslHMbj32BiB%2FScreenshot%202025-12-01%20at%207.40.47%E2%80%AFPM.png?alt=media&#x26;token=641f2d97-8e1f-48ae-8e88-654eb18c64af" alt="" width="375"><figcaption><p>Marketing email with only Bcc recipients.</p></figcaption></figure>
