megachangelog
Feature

Manage Email Routing rules with Wrangler

You can now configure Email Routing rules directly in your Wrangler configuration file to route emails to Workers. Wrangler will automatically create, update, and remove rules when you deploy, with confirmation prompts for destructive changes.

You can now manage Email Routing rules that route emails to Workers from your Wrangler configuration. Add literal addresses or a catch-all address to the top-level addresses field:

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "name": "invoice-handler",
  "main": "src/index.ts",
  // Set this to today's date
  "compatibility_date": "2026-09-25",
  "addresses": [
    "invoice@yourdomain.com"
  ]
}
name = "invoice-handler"
main = "src/index.ts"
# Set this to today's date
compatibility_date = "2026-09-25"
addresses = ["invoice@yourdomain.com"]

When you run wrangler deploy, Wrangler creates rules for new addresses, updates existing rules managed by the Worker, and removes managed rules that are no longer in the configuration. Wrangler shows the planned changes and asks for confirmation before applying potentially destructive changes.

Email Routing rules created by Wrangler also appear in the dashboard but with an icon that identifies them.

Email Routing rule created by Wrangler in dashboard

Refer to Configure rules with Wrangler for more information.

email-routingworkerswranglerconfiguration

Source: original entry ↗