Skip to content

email: Add a note about multiple destinations #19066

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jan 21, 2025
Merged

email: Add a note about multiple destinations #19066

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a38e1fb
Update enable-email-routing.mdx
jbrandeb Jan 7, 2025
a28b1f4
PCX review (formatting, avoid two note blocks in a row)
pedrosousa Jan 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 7 additions & 12 deletions src/content/docs/email-routing/get-started/enable-email-routing.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,10 @@ title: Enable Email Routing
pcx_content_type: get-started
sidebar:
order: 1

---

:::caution[Important]


Enabling Email Routing adds the appropriate `MX` records to the DNS settings of your zone in order for the service to work. You can [change these `MX` records](/email-routing/setup/email-routing-dns-records/) at any time. However, depending on how you configure them, Email Routing might stop working.


:::

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account and domain.
Expand All @@ -23,9 +18,13 @@ Enabling Email Routing adds the appropriate `MX` records to the DNS settings of
7. Enter the custom email address you want to use (for example, `[email protected]`).
8. In **Destination addresses**, enter the full email address you want your emails to be forwarded to — for example, `[email protected]`.

:::note
If you have several destination addresses linked to the same custom email address (rule), Email Routing will only process the most recent rule. To avoid this, do not link several destination addresses to the same custom address.
:::
:::note[Notes]

If you have several destination addresses linked to the same custom email address (rule), Email Routing will only process the most recent rule. To avoid this, do not link several destination addresses to the same custom address.

The current implementation of email forwarding only supports a single destination address per custom address. To forward a custom address to multiple destinations you must create a Workers script to redirect the email to each destination. All the destinations used in the Workers script must be already validated.

:::

9. Select **Save**.
10. Cloudflare will send a verification email to the address provided in the **Destination address** field. You must verify your email address before being able to proceed.
Expand All @@ -36,9 +35,5 @@ If you have several destination addresses linked to the same custom email addres
Email Routing is now enabled. You can add other custom addresses to your account.

:::note


When Email Routing is configured and running, no other email services can be active in the domain you are configuring. If there are other `MX` records already configured in DNS, Cloudflare will ask you if you wish to delete them. If you do not delete existing `MX` records, Email Routing will not be enabled.


:::
Loading