Skip to content

Commit 1cda039

Browse files
authored
Subaddressing docs and changelog entry (#23794)
* Subaddressing docs and changelog entry * precedences
1 parent 1c7e128 commit 1cda039

File tree

4 files changed

+29
-4
lines changed

4 files changed

+29
-4
lines changed
86.1 KB
Loading
Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
title: Subaddressing support in Email Routing
3+
description: Subaddressing, also known as plus addressing, is now supported in Email Routing.
4+
date: 2025-07-21
5+
---
6+
7+
Subaddressing, as defined in [RFC 5233](https://www.rfc-editor.org/rfc/rfc5233), also known as plus addressing, is now supported in Email Routing. This enables using the "+" separator to augment your custom addresses with arbitrary detail information.
8+
9+
Now you can send an email to `[email protected]` and it will be captured by the `[email protected]` custom address. The `+detail` part is ignored by Email Routing, but it can be captured next in the processing chain in the logs, an [Email Worker](/email-routing/email-workers/) or an [Agent application](https://github.com/cloudflare/agents/tree/main/examples/email-agent).
10+
11+
Customers can use this feature to dynamically add context to their emails, such as tracking the source of an email or categorizing emails without needing to create multiple custom addresses.
12+
13+
![Subaddressing](~/assets/images/changelog/email-routing/subaddressing.png)
14+
15+
Check our [Developer Docs](/email-routing/setup/email-routing-addresses/#subaddressing) to learn on to enable subaddressing in Email Routing.

src/content/docs/email-routing/postmaster.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -230,6 +230,6 @@ Due to the nature of email forwarding, restrictive DMARC policies might make for
230230

231231
Email Routing does not support sending or replying from your Cloudflare domain. When you reply to emails forwarded by Email Routing, the reply will be sent from your destination address (like `[email protected]`), not your custom address (like `[email protected]`).
232232

233-
### Signs such "`+`" and "`.`" are treated as normal characters for custom addresses
233+
### "`.`" is treated as normal characters for custom addresses
234234

235-
Email Routing does not have advanced routing options. Characters such as `+` or `.`, which perform special actions in email providers like Gmail and Outlook, are currently treated as normal characters on custom addresses. More flexible routing options are in our roadmap.
235+
The `.` character, which perform special actions in email providers like Gmail, is treated as a normal character on custom addresses.

src/content/docs/email-routing/setup/email-routing-addresses.mdx

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ An email rule is a pair of a custom email address and a destination address, or
1919

2020
:::note
2121

22-
If you have more than one destination address linked to the same custom address, Email Routing will only process the most recent rule. This means only the most recent pair of custom address and destination address (rule) will receive your forwarded emails. To avoid this, do not link more than one destination address to the same custom address.
22+
If you have more than one destination address linked to the same custom address, Email Routing will only process the most recent rule. This means only the most recent pair of custom address and destination address (rule) will receive your forwarded emails. To avoid this, do not link more than one destination address to the same custom address.
2323
:::
2424

2525
### Email rule actions
@@ -65,6 +65,16 @@ To enable Catch-all addresses:
6565
4. In the **Action** drop-down menu, select what to do with these emails. Refer to [Email rule actions](#email-rule-actions) for more information.
6666
5. Select **Save**.
6767

68+
## Subaddressing
69+
70+
Email Routing supports subaddressing, also known as plus addressing, as defined in [RFC 5233](https://www.rfc-editor.org/rfc/rfc5233). This enables using the "+" separator to augment your custom addresses with arbitrary detail information.
71+
72+
You can enable subaddressing at **Email** > **Email Routing** > **Settings**.
73+
74+
Once enabled, you can use subaddressing with any of your custom addresses. For example, if you send an email to `[email protected]` it will be captured by the `[email protected]` custom address. The `+detail` part is ignored by Email Routing, but it can be captured next in the processing chain in the logs, an [Email Worker](/email-routing/email-workers/) or an [Agent application](https://github.com/cloudflare/agents/tree/main/examples/email-agent).
75+
76+
If a custom address '[email protected]` already exists, it will take precedence over '[email protected]'. This prevents breaking existing routing rules for users, and allows certain sub-addresses to be captured by a specific rule.
77+
6878
## Destination addresses
6979

7080
This section lets you manage your destination addresses. It lists all email addresses already verified, as well as email addresses pending verification. You can resend verification emails or delete destination addresses.
@@ -79,4 +89,4 @@ To prevent spam, email rules do not become active until after the destination ad
7989
Deleting a destination address automatically disables all email rules that use that email address as destination.
8090

8191

82-
:::
92+
:::

0 commit comments

Comments
 (0)