# wrangler.toml

> **TL;DR.** wrangler.

- **Category:** DevOps / Cloud / Edge / Configuration
- **Stage:** established
- **Age:** 2401 days
- **Origin date:** 2019-11-19
- **First detected:** 2026-04-20
- **Canonical URL:** https://earlyterms.com/term/wrangler-toml
- **Sources:** 6 primary URLs

## Definition

wrangler.toml is the configuration file for Cloudflare's Wrangler CLI, the tool that deploys code to Cloudflare Workers. It pins the Worker's name, entry script, compatibility date, account, routes, and bindings (KV, R2, D1, Durable Objects, secrets) in a single checked-in file.

It has existed since Wrangler shipped in 2019. The new detail is that as of Wrangler [v3.91 (Nov 2024)](https://developers.cloudflare.com/workers/wrangler/configuration/), JSON and JSONC equivalents (wrangler.json / wrangler.jsonc) are supported, and `npm create cloudflare@latest` now scaffolds wrangler.jsonc by default — splitting the ecosystem between the two formats.

## Example

A minimal wrangler.toml binds a Worker to an account, a route, and a KV namespace in about ten lines: `name = "my-worker"`, `main = "src/index.ts"`, `compatibility_date = "2026-04-01"`, then `[[kv_namespaces]]` with `binding` and `id`. Every `wrangler deploy` reads this file to know what to ship.

## Analogy

If package.json describes what your project is, wrangler.toml describes where it lives on Cloudflare's edge.

## Why it's emerging now

wrangler.toml is a mature filename, not a coinage — but the file's role is quietly shifting. Since Wrangler v3.91 in late 2024, Cloudflare supports wrangler.json/wrangler.jsonc, and `npm create cloudflare@latest` now defaults to JSONC for new projects, leaving existing TOML codebases to choose between migrating and staying put.

## Related terms

- *alias:* wrangler.jsonc
- *alias:* wrangler.json
- *parent:* Cloudflare Workers
- *parent:* Wrangler CLI
- *related:* compatibility_date
- *child:* KV namespace binding
- *related:* Durable Objects
- *related:* cloudflare-mesh
- *related:* agents-md
- *related:* mcp-server

## Sources

1. [Cloudflare Workers: Wrangler Configuration Reference](https://developers.cloudflare.com/workers/wrangler/configuration/)
2. [Cloudflare Workers: Wrangler Deprecations](https://developers.cloudflare.com/workers/wrangler/deprecations/)
3. [cloudflare/workerd Discussion: Why does npm create cloudflare create a wrangler.jsonc](https://github.com/cloudflare/workerd/discussions/3559)
4. [honojs/starter Issue #69: Cloudflare Workers now use wrangler.json by default](https://github.com/honojs/starter/issues/69)
5. [jalmonter/wrangler-cfg: TOML-to-JSONC migration CLI](https://github.com/jalmonter/wrangler-cfg)
6. [Cloudflare Workers: Environment Variables](https://developers.cloudflare.com/workers/configuration/environment-variables/)

---
_Generated by EarlyTerms · https://earlyterms.com/term/wrangler-toml_