1# Binding Configuration Reference
2 
3## Storage Bindings
4 
5```jsonc
6{
7  "kv_namespaces": [{ "binding": "MY_KV", "id": "..." }],
8  "r2_buckets": [{ "binding": "MY_BUCKET", "bucket_name": "my-bucket" }],
9  "d1_databases": [{ "binding": "DB", "database_name": "my-db", "database_id": "..." }],
10  "durable_objects": { "bindings": [{ "name": "MY_DO", "class_name": "MyDO" }] },
11  "vectorize": [{ "binding": "VECTORIZE", "index_name": "my-index" }],
12  "queues": { "producers": [{ "binding": "MY_QUEUE", "queue": "my-queue" }] }
13}
14```
15 
16**Create commands:**
17```bash
18npx wrangler kv namespace create MY_KV
19npx wrangler r2 bucket create my-bucket
20npx wrangler d1 create my-db
21npx wrangler vectorize create my-index --dimensions=768 --metric=cosine
22npx wrangler queues create my-queue
23 
24# List existing resources
25npx wrangler kv namespace list
26npx wrangler r2 bucket list
27npx wrangler d1 list
28npx wrangler vectorize list
29npx wrangler queues list
30```
31 
32## Compute Bindings
33 
34```jsonc
35{
36  "services": [{ 
37    "binding": "MY_SERVICE", 
38    "service": "other-worker",
39    "environment": "production"  // Optional: target specific env
40  }],
41  "ai": { "binding": "AI" },
42  "browser": { "binding": "BROWSER" },
43  "workflows": [{ "binding": "MY_WORKFLOW", "name": "my-workflow" }]
44}
45```
46 
47**Create workflows:**
48```bash
49npx wrangler workflows create my-workflow
50```
51 
52## Platform Bindings
53 
54```jsonc
55{
56  "analytics_engine_datasets": [{ "binding": "ANALYTICS" }],
57  "mtls_certificates": [{ "binding": "MY_CERT", "certificate_id": "..." }],
58  "hyperdrive": [{ "binding": "HYPERDRIVE", "id": "..." }],
59  "unsafe": {
60    "bindings": [{ "name": "RATE_LIMITER", "type": "ratelimit", "namespace_id": "..." }]
61  }
62}
63```
64 
65## Configuration Bindings
66 
67```jsonc
68{
69  "vars": {
70    "API_URL": "https://api.example.com",
71    "MAX_RETRIES": "3"
72  },
73  "text_blobs": { "MY_TEXT": "./data/template.html" },
74  "data_blobs": { "MY_DATA": "./data/config.bin" },
75  "wasm_modules": { "MY_WASM": "./build/module.wasm" }
76}
77```
78 
79**Secrets (never in config):**
80```bash
81npx wrangler secret put API_KEY
82```
83 
84## Environment-Specific Configuration
85 
86```jsonc
87{
88  "name": "my-worker",
89  "vars": { "ENV": "production" },
90  "kv_namespaces": [{ "binding": "CACHE", "id": "prod-kv-id" }],
91  
92  "env": {
93    "staging": {
94      "vars": { "ENV": "staging" },
95      "kv_namespaces": [{ "binding": "CACHE", "id": "staging-kv-id" }]
96    }
97  }
98}
99```
100 
101**Deploy:**
102```bash
103npx wrangler deploy              # Production
104npx wrangler deploy --env staging
105```
106 
107## Local Development
108 
109```jsonc
110{
111  "kv_namespaces": [{
112    "binding": "MY_KV",
113    "id": "prod-id",
114    "preview_id": "dev-id"  // Used in wrangler dev
115  }]
116}
117```
118 
119**Or use remote:**
120```bash
121npx wrangler dev --remote  # Uses production bindings
122```
123 
124## Complete Example
125 
126```jsonc
127{
128  "$schema": "./node_modules/wrangler/config-schema.json",
129  "name": "my-app",
130  "main": "src/index.ts",
131  "compatibility_date": "2025-01-01",
132  
133  "vars": { "API_URL": "https://api.example.com" },
134  "kv_namespaces": [{ "binding": "CACHE", "id": "abc123" }],
135  "r2_buckets": [{ "binding": "ASSETS", "bucket_name": "my-assets" }],
136  "d1_databases": [{ "binding": "DB", "database_name": "my-db", "database_id": "xyz789" }],
137  "services": [{ "binding": "AUTH", "service": "auth-worker" }],
138  "ai": { "binding": "AI" }
139}
140```
141 
142## Binding-Specific Configuration
143 
144### Durable Objects with Class Export
145 
146```jsonc
147{
148  "durable_objects": {
149    "bindings": [
150      { "name": "COUNTER", "class_name": "Counter", "script_name": "my-worker" }
151    ]
152  }
153}
154```
155 
156```typescript
157// In same Worker or script_name Worker
158export class Counter {
159  constructor(private state: DurableObjectState, private env: Env) {}
160  async fetch(request: Request) { /* ... */ }
161}
162```
163 
164### Queue Consumers
165 
166```jsonc
167{
168  "queues": {
169    "producers": [{ "binding": "MY_QUEUE", "queue": "my-queue" }],
170    "consumers": [{ "queue": "my-queue", "max_batch_size": 10 }]
171  }
172}
173```
174 
175Queue consumer handler: `export default { async queue(batch, env) { /* process batch.messages */ } }`
176 
177## Key Points
178 
179- **64 binding limit** (all types combined)
180- **Secrets**: Always use `wrangler secret put`, never commit
181- **Types**: Run `npx wrangler types` after config changes
182- **Environments**: Use `env` field for staging/production variants
183- **Development**: Use `preview_id` or `--remote` flag
184- **IDs vs Names**: Some bindings use `id` (KV, D1), others use `name` (R2, Queues)
185 
186## See Also
187 
188- [Wrangler Configuration](https://developers.cloudflare.com/workers/wrangler/configuration/)