-
Notifications
You must be signed in to change notification settings - Fork 9.9k
Subaddressing docs and changelog entry #23794
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.
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
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
15 changes: 15 additions & 0 deletions
15
src/content/changelog/email-routing/2025-07-21-subaddressing.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| --- | ||
| title: Subaddressing support in Email Routing | ||
| description: Subaddressing, also known as plus addressing, is now supported in Email Routing. | ||
| date: 2025-07-21 | ||
| --- | ||
|
|
||
| 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. | ||
|
|
||
| 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). | ||
|
|
||
| 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. | ||
|
|
||
|  | ||
|
|
||
| Check our [Developer Docs](/email-routing/setup/email-routing-addresses/#subaddressing) to learn on to enable subaddressing in Email Routing. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -230,6 +230,6 @@ Due to the nature of email forwarding, restrictive DMARC policies might make for | |
|
|
||
| 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]`). | ||
|
|
||
| ### Signs such "`+`" and "`.`" are treated as normal characters for custom addresses | ||
| ### "`.`" is treated as normal characters for custom addresses | ||
|
|
||
| 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. | ||
| The `.` character, which perform special actions in email providers like Gmail, is treated as a normal character on custom addresses. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -19,7 +19,7 @@ An email rule is a pair of a custom email address and a destination address, or | |
|
|
||
| :::note | ||
|
|
||
| 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. | ||
| 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. | ||
| ::: | ||
|
|
||
| ### Email rule actions | ||
|
|
@@ -65,6 +65,14 @@ To enable Catch-all addresses: | |
| 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. | ||
| 5. Select **Save**. | ||
|
|
||
| ## Subaddressing | ||
|
|
||
| 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. | ||
|
|
||
| You can enable subaddressing at **Email** > **Email Routing** > **Settings**. | ||
|
|
||
| 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). | ||
|
|
||
| ## Destination addresses | ||
|
|
||
| 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 +87,4 @@ To prevent spam, email rules do not become active until after the destination ad | |
| Deleting a destination address automatically disables all email rules that use that email address as destination. | ||
|
|
||
|
|
||
| ::: | ||
| ::: | ||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.