Configure rules and addresses

An email rule is a pair of a custom email address and a destination address, or a custom email address with an Email Worker. This allows you to route emails to your preferred inbox, or apply logic through Email Workers before deciding what should happen to your emails. You can have multiple custom addresses, to route email from specific providers to specific mail inboxes.

Custom addresses

1. Log in to the Cloudflare dashboard ↗ and select your account and domain.
2. Go to Email > Email Routing > Routes.
3. Select Create address.
4. In Custom address, enter the custom email address you want to use (for example, my-new-email).
5. In the Action drop-down menu, choose what this email rule should do. Refer to Email rule actions for more information.
6. In Destination, choose the email address or Email Worker you want your emails to be forwarded to — for example, your-name@gmail.com. You can only choose a destination address you have already verified. To add a new destination address, refer to Destination addresses.

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.

Email rule actions

When creating an email rule, you must specify an Action:

• Send to an email: Emails will be routed to your destination address. This is the default action.
• Send to a Worker: Emails will be processed by the logic in your Email Worker.
• Drop: Deletes emails sent to the custom address without routing them. This can be useful if you want to make an email address appear valid for privacy reasons.

Note

To prevent spamming unintended recipients, all email rules are automatically disabled until the destination address is validated by the user.

Disable an email rule

1. Log in to the Cloudflare dashboard ↗ and select your account and domain.
2. Go to Email > Email Routing > Routes.
3. In Custom addresses, identify the email rule you want to pause, and toggle the status button to Disabled.

Your email rule is now disabled. It will not forward emails to a destination address or Email Worker. To forward emails again, toggle the email rule status button to Active.

Edit custom addresses

1. Log in to the Cloudflare dashboard ↗ and select your account and domain.
2. Go to Email > Email Routing > Routes.
3. In Custom addresses, identify the email rule you want to edit, and select Edit.
4. Make the appropriate changes to this custom address.

Catch-all address

When you enable this feature, Email Routing will catch variations of email addresses to make them valid for the specified domain. For example, if you created an email rule for info@example.com and a sender accidentally types ifno@example.com, the email will still be correctly handled if you have Catch-all addresses enabled.

To enable Catch-all addresses:

1. Log in to the Cloudflare dashboard ↗ and select your account and domain.
2. Go to Email > Email Routing > Routes.
3. Enable Catch-all address, so it shows as Active.
4. In the Action drop-down menu, select what to do with these emails. Refer to Email rule actions for more information.
5. Select Save.

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.

Destination addresses are shared at the account level, and can be reused with any other domain in your account. This means the same destination address will be available to different domains in your account.

To prevent spam, email rules do not become active until after the destination address has been verified. Cloudflare sends a verification email to destination addresses specified in Custom addresses. You have to select Verify email address in that email to activate a destination address.

Note

Deleting a destination address automatically disables all email rules that use that email address as destination.

Was this helpful?

What did you like?

Accurate

Easy to understand

Solved my problem

Helped me decide to use the product

Other

What went wrong?

Hard to understand

Incorrect information

Missing the information

Other

Thank you for helping improve Cloudflare's documentation!