[wrangler] Add top-level addresses config field for Email Routing

[DiogoSantoss]

Adds a top-level addresses field to Wrangler configuration for Email Routing.

You can declare the inbound email addresses handled by a Worker directly in wrangler.json:

{
	"name": "my-worker",
	"main": "src/index.ts",
	"compatibility_date": "2026-05-21",
	"addresses": ["support@example.com", "*@example.com"]
}

Each entry is a literal recipient address or a *@domain catch-all. addresses is top-level only (it applies to every environment and cannot be set under env.*) and is validated locally (array of non-empty strings, no exact duplicates). wrangler deploy --dry-run validates the field and prints the resolved set without any network calls. Applying the addresses during wrangler deploy follows in a stacked PR.

Internal tracking: EMAIL-1880 / RM-29262.

---

• Tests
  • Tests included/updated
  • Automated tests not possible - manual testing has been completed as follows:
  • Additional testing not necessary because:
• Public documentation
  • Cloudflare docs PR(s): [Email Routing] Document the addresses Wrangler configuration field cloudflare-docs#31772 (draft — merges when this feature ships)
  • Documentation not necessary because: documentation lands with the full Email Routing wrangler.json feature (separate ticket); this PR is config parsing/validation only.

🐱

[changeset-bot]

🦋 Changeset detected

Latest commit: 0ac6690

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
wrangler	Minor
@cloudflare/vite-plugin	Patch
@cloudflare/vitest-pool-workers	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[workers-devprod]

Codeowners approval required for this PR:

• ✅ @cloudflare/wrangler

Show detailed file reviewers

[pkg-pr-new]

@cloudflare/autoconfig

npm i https://pkg.pr.new/@cloudflare/autoconfig@14470

@cloudflare/config

npm i https://pkg.pr.new/@cloudflare/config@14470

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@14470

@cloudflare/deploy-helpers

npm i https://pkg.pr.new/@cloudflare/deploy-helpers@14470

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@14470

miniflare

npm i https://pkg.pr.new/miniflare@14470

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@14470

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@14470

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@14470

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@14470

@cloudflare/workers-auth

npm i https://pkg.pr.new/@cloudflare/workers-auth@14470

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@14470

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@14470

wrangler

npm i https://pkg.pr.new/wrangler@14470

commit: 0ac6690

[workers-devprod]

Codeowners reviews satisfied

[workers-devprod]

Codeowners approval required for this PR:

• ✅ @cloudflare/wrangler

Show detailed file reviewers