Email Service overview shows unsupported `"email": [{"name":"EMAIL_HANDLER"}]` Wrangler config

[catwithlover]

Existing documentation URL(s)

• https://developers.cloudflare.com/email-service/

What changes are you suggesting?

The Email Service overview currently shows this Wrangler configuration:

// Email routing
"email": [
  {
    "name": "EMAIL_HANDLER"
  }
]

However, inbound Email Routing is handled through the Worker's exported email() handler, and the current Wrangler schema/configuration reference does not appear to define a top-level email binding/config field.

The newer Wrangler-managed routing configuration appears to use addresses instead.

Is the email example stale or incorrect? If so, it should probably be removed or replaced with an addresses example once that feature is documented.

Additional information

No response

[vahidshaik1901]

Opened #33259 for this — your read was right.

Checked against the published wrangler@4.129.0 config-schema.json:

• send_email — present (the outbound Email Sending binding)
• addresses — present, top-level array
• email — not present at all

So the overview's "email": [{ "name": "EMAIL_HANDLER" }] block produced a configuration Wrangler does not recognise, and addresses is indeed the field to use. The schema describes it as the inbound addresses handled by the Worker, each entry being a literal recipient or a *@domain catch-all, creating an Email Routing rule per entry, top-level only and not settable under env.*.

The example now uses support@yourdomain.com so it lines up with the email() handler shown directly above it, which checks message.to.includes("support@yourdomain.com"). send_email is left as-is since it is correct.