Configure options below — the preview updates in real time.

General

Top-level Worker identity and runtime settings.

The name of your Cloudflare Worker (alphanumeric and dashes).

The entrypoint file for your Worker (e.g. src/index.ts).

Date (YYYY-MM-DD) determining which Workers runtime version to use.

Runtime feature flags to enable specific capabilities.

Cloudflare Account ID for deployments.

Workers Dev SubdomainDeploy to the <name>.<subdomain>.workers.dev zone.
Keep Dashboard VariablesRetain environment variables configured in the Cloudflare Dashboard during deployment.
Preview URLsEnable preview URLs for the Worker. Defaults to the value of workers_dev.
Send MetricsSend telemetry data to Cloudflare.
Upload Source MapsAutomatically generate and upload source maps for error tracking.

Output directory of the build step for Cloudflare Pages only.

Build & Bundling

Custom build steps, module rules, minification, and TypeScript settings.

Custom command to run before deployment (e.g. npm run build).

Working directory for the build command.

Directory to watch for changes during development.

MinifyMinify the output bundle.
No BundleSkip internal build steps and bundling. When true, Wrangler will not process your code.
Find Additional ModulesAttempt to bundle additional unreferenced files based on base_dir. Defaults to true if no_bundle is true.
Preserve File NamesPreserve original file names of additional modules instead of prepending a content hash.
Keep NamesKeep original function and class names in the bundled output.

Base directory for unbundled/external modules.

Path to a custom TypeScript configuration file.

A map of global variable names to replacement values applied during bundling.

A map of module names to substitute when deploying your Worker.

Routing & Placement

Route patterns, custom domains, and Smart Placement configuration.

A single route pattern string to map requests to the Worker (e.g. example.com/*).

Multiple route pattern strings for the Worker.

Smart Placement automatically runs workloads in optimal global locations.

Target a specific cloud provider region (e.g. aws:us-east-1, gcp:europe-west1, azure:westeurope). Mutually exclusive with other placement hints.

A host:port to probe via TCP (layer 4) for single-homed services like databases. Mutually exclusive with other placement hints.

A hostname to probe via HTTP (layer 7) for single-homed API services. Mutually exclusive with other placement hints.

Triggers & Observability

Scheduled triggers (crons) and observability configuration.

Cron expressions for scheduled Worker execution.

LogpushForward execution logs to Cloudflare Logpush.
Observability EnabledEnable native Workers observability.

Request sampling rate for observability (0.0 to 1.0).

Environment Variables

Static plaintext variables accessible in the Worker runtime.

Key-value environment variables available globally in the Worker script.

KV Namespaces

Bind Cloudflare KV key-value storage namespaces to the Worker.

Array of KV bindings as JSON. Each has binding (string) and id (string).

D1 Databases

Bind serverless SQL databases to the Worker.

Array of D1 bindings as JSON. Each has binding, database_name, database_id, and optional preview_database_id and migrations_dir.

R2 Buckets

Bind S3-compatible R2 Object Storage buckets.

Array of R2 bindings as JSON. Each has binding and bucket_name.

Service Bindings

Connect to other Workers via RPC or fetch-based service bindings.

Array of service bindings as JSON. Each has binding, service, and optional entrypoint.

Durable Objects

Bind Durable Objects for coordinated, stateful compute.

Durable Object bindings as JSON. Object with bindings array, each containing name and class_name.

Queues

Message queue bindings for producing and consuming events.

Array of queue producer bindings as JSON. Each has binding and queue.

Array of queue consumer configs as JSON. Each has queue, max_batch_size, max_retries, etc.

Hyperdrive

Accelerate database queries via Hyperdrive connection pooling.

Array of Hyperdrive bindings as JSON. Each has binding and id.

Vectorize

Bind Vectorize indexes for embeddings and AI semantic search.

Array of Vectorize bindings as JSON. Each has binding and index_name.

AI, Images & Browser Rendering

Bind the Workers AI model catalog, Cloudflare Images API, and headless browser instances.

Binding name for Cloudflare Workers AI.

Binding name for the Cloudflare Images transform API.

Binding name for headless Browser Rendering.

Binding name exposing deployment version IDs at runtime.

Analytics Engine

Write custom analytics and metrics at the edge.

Array of analytics dataset bindings as JSON. Each has binding and dataset.

mTLS Certificates

Bind mutual TLS client certificates.

Array of mTLS certificate bindings as JSON. Each has binding and certificate_id.

Email Routing

Configure outbound email sending via Email Routing.

Array of email routing bindings as JSON. Each has name, destination_address, and optional allowed_destination_addresses.

Workflows

Durable Workflows with retry and sleep mechanisms.

Array of workflow bindings as JSON. Each has binding, name, class_name, and optional script_name.

Static Assets

Serve static frontend assets alongside the Worker without Cloudflare Pages.

Directory containing static assets to serve.

Optional binding name for programmatic access to static assets.

Run Worker FirstInvoke the Worker before serving static assets. Set to true for all requests, or provide route patterns.

How to handle trailing slashes for HTML files.

How to handle 404 responses for static assets.

Development

Settings for local development with wrangler dev.

IP address to bind the local dev server to. Defaults to localhost.

Port for the local development server. Defaults to 8787.

Protocol for the local dev server.

Protocol used for forwarding requests from the local dev server. Defaults to https.

Hostname for the local dev server.

Site (Legacy)

Legacy Workers Sites configuration. Use Assets or Cloudflare Pages for new projects.

Directory of static assets for Workers Sites.

File patterns to include in the site upload.

File patterns to exclude from the site upload.

Tail Consumers

Route logs to other Workers configured to consume tail events.

Array of tail consumer bindings as JSON. Each has service and optional environment.

Dispatch Namespaces

Dynamic dispatch routing for Workers for Platforms.

Array of dispatch namespace bindings as JSON. Each has binding and namespace.

Legacy Blobs

Legacy bindings for embedding static WASM, text, and data files.

Key-value map of binding names to WASM file paths.

Key-value map of binding names to text file paths.

Key-value map of binding names to binary data file paths.

Limits

Configure per-invocation CPU and subrequest limits for the Worker.

Maximum CPU time allowed per invocation, in milliseconds. Max 300,000ms.

Durable Object Migrations

Apply class configuration changes to Durable Objects.

Array of migration steps as JSON. Each has tag, new_classes, renamed_classes, deleted_classes, etc.