Get started (57)

Last updated Sep 22, 2026 You can create a Preview for a new or existing Worker. You do not need to deploy a Worker to production before creating its first Preview.

Before you begin

Worker Previews requires Wrangler 4.135.0 or later. Update the project dependency because project commands do not use a newer global installation.

npmyarnpnpmbun

npm i -D wrangler@latest

yarn add -D wrangler@latest

pnpm add -D wrangler@latest

bun add -d wrangler@latest

Step 1: Configure Preview settings

Add a previews block to your Wrangler configuration file. Top-level settings define production, and the previews block defines Preview settings. The previews block can be empty if your Preview does not need separate settings.

{
  // ...
  "vars": {
    "ENVIRONMENT": "production"
  },
  // ...
  "previews": {
    // ...
    "vars": {
      "ENVIRONMENT": "preview"
    }
    // ...
  }
}

[vars]
ENVIRONMENT = "production"

[previews.vars]
ENVIRONMENT = "preview"

To determine which settings belong at the top level or in previews, refer to What goes in the previews block.

Settings that you add or import in the dashboard must also be copied to your Wrangler configuration file.

Step 2: Deploy a Preview

Run the same Preview command locally or in your existing CI workflow:

npmyarnpnpm

npx wrangler preview

yarn wrangler preview

pnpm wrangler preview

The Preview name defaults to your current Git branch. To choose a name, add --name <PREVIEW_NAME>.

To post Preview URLs automatically to pull requests or merge requests, connect your Git repository and use Workers Builds. New Workers use Worker Previews by default. If an existing Worker already uses Workers Builds, complete the one-time setup.

A successful deployment returns a Preview URL that always points to the latest changes. It also returns a Unique Deployment URL for each deployment, so you can access earlier versions in the Preview's deployment history.

Next steps

Was this helpful?

YesNo

On this page

Get started (57) - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/previews/get-started/#page","headline":"Get started","description":"Create a Worker Preview and configure preview-safe settings with Wrangler.","url":"https://developers.cloudflare.com/workers/previews/get-started/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/previews/get-started/og.png?v=2eb6967b7d478d0d","dateModified":"2026-09-22","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Understand which Preview resources are shared, which are isolated, and which invocation types have limitations. title: Resources and isolation image: https://developers.cloudflare.com/workers/previews/resources/og.png?v=a51699232e855b7d

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/workers/llms.txt
Use this file to discover all available pages before exploring further.