Email Service, Workers - Manage Email Routing rules with Wrangler

<p>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 <code>addresses</code> field:</p> <div data-nb-tabs data-nb-sync-key="wranglerConfig" class><div class="relative flex border-b border-border" role="tablist" data-nb-tabs-list><span class="bg-primary pointer-events-none absolute -bottom-px h-0.5 rounded-t-sm transition-[left,width] duration-200 ease-out" data-nb-tabs-indicator aria-hidden="true"></span></div><div class="mt-3"><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="wrangler.jsonc" class><figure class="nb-code-figure" data-nb-lang="jsonc"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="jsonc" data-nb-lang="jsonc"><code><span class="line"><span class="nb-shiki-140thh">{</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "$schema"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-mdbnqw">"./node_modules/wrangler/config-schema.json"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "name"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-mdbnqw">"invoice-handler"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "main"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-mdbnqw">"src/index.ts"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-21nrsd"> // Set this to today's date</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "compatibility_date"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-mdbnqw">"2026-10-25"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "addresses"</span><span class="nb-shiki-140thh">: [</span></span> <span class="line"><span class="nb-shiki-mdbnqw"> "invoice@yourdomain.com"</span></span> <span class="line"><span class="nb-shiki-140thh"> ]</span></span> <span class="line"><span class="nb-shiki-140thh">}</span></span></code></pre></figure></div><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="wrangler.toml" class><figure class="nb-code-figure" data-nb-lang="toml"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="toml" data-nb-lang="toml"><code><span class="line"><span class="nb-shiki-140thh">name = </span><span class="nb-shiki-mdbnqw">"invoice-handler"</span></span> <span class="line"><span class="nb-shiki-140thh">main = </span><span class="nb-shiki-mdbnqw">"src/index.ts"</span></span> <span class="line"><span class="nb-shiki-21nrsd"># Set this to today's date</span></span> <span class="line"><span class="nb-shiki-140thh">compatibility_date = </span><span class="nb-shiki-mdbnqw">"2026-10-25"</span></span> <span class="line"><span class="nb-shiki-140thh">addresses = [</span><span class="nb-shiki-mdbnqw">"invoice@yourdomain.com"</span><span class="nb-shiki-140thh">]</span></span></code></pre></figure></div></div></div><script type="module" src="https://developers.cloudflare.com/home/runner/work/cloudflare-docs/cloudflare-docs/src/components/ui/tabs/Tabs.astro?astro&type=script&index=0&lang.ts"></script> <p>When you run <code>wrangler deploy</code>, 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.</p> <p>Email Routing rules created by Wrangler also appear in the dashboard but with an icon that identifies them.</p> <img src="https://developers.cloudflare.com/cdn-cgi/image/onerror=redirect,width=2440,height=526,format=webp/_astro/wrangler-email-routing-rules-dash.BZQZlAJI.png" alt="Email Routing rule created by Wrangler in dashboard" loading="lazy" decoding="async" width="2440" height="526"> <p>Refer to <a href="https://developers.cloudflare.com/email-service/configuration/email-routing-addresses/#configure-rules-with-wrangler">Configure rules with Wrangler</a> for more information.</p>