Skip to content
This repository was archived by the owner on Jun 26, 2026. It is now read-only.

Commit d235cee

Browse files
authored
Merge pull request #1127 from novuhq/cursor/docs-sync-automation-5908
docs(providers): sync email replaceToRecipient behavior (DOC-349)
2 parents 0f42293 + 0614ba2 commit d235cee

1 file changed

Lines changed: 15 additions & 1 deletion

File tree

  • content/docs/platform/integrations/email

content/docs/platform/integrations/email/index.mdx

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -202,7 +202,21 @@ await novu.trigger({
202202
</Tab>
203203
</Tabs>
204204

205-
<Callout type="info">By default, Novu merges override `to` addresses with the subscriber email. Set `replaceToRecipient: true` to send only to the override recipients and omit the subscriber email from `to`. When `replaceToRecipient` is `true`, include at least one of `to`, `cc`, or `bcc` in the email override. If `to` is empty but `cc` or `bcc` is set, Novu uses the `from` address as `to`.</Callout>
205+
<Callout type="info">
206+
207+
**`replaceToRecipient`**
208+
209+
- By default, Novu merges override `to` addresses with the subscriber email.
210+
- Set `replaceToRecipient: true` to send only to override recipients. The subscriber email is omitted from `to`. `to` is replaced with the `from` address.
211+
- When `replaceToRecipient` is `true`, include at least one of `to`, `cc`, or `bcc`.
212+
213+
**Empty `to` with cc/bcc (Custom SMTP only)**
214+
215+
- Setting `to: []` with `cc` or `bcc` is supported only on **Custom SMTP (Nodemailer)**.
216+
- Novu normalizes an empty `to` to `undisclosed-recipients:;` so the message sends without exposing addresses in the To field.
217+
- Other email providers do not support this pattern.
218+
219+
</Callout>
206220

207221
### Targeting a specific provider
208222

0 commit comments

Comments
 (0)