Skip to content
Cloudflare Docs

Migrate from Netlify to Workers

Last reviewed: 22 days ago

In this tutorial, you will learn how to migrate your Netlify application to Cloudflare Workers.

You should already have an existing project deployed on Netlify that you would like to host on Cloudflare Workers. Netlify specific features are not supported by Cloudflare Workers. Review the Workers compatibility matrix for more information on what is supported.

Frameworks

Some frameworks like Next.js, Astro with on demand rendering, and others have specific guides for migrating to Cloudflare Workers. Refer to our framework guides for more information. If your framework has a Deploy an existing project on Workers guide, follow that guide for specific instructions. Otherwise, continue with the steps below.

Find your build command and build directory

To move your application to Cloudflare Workers, you will need to know your build command and build directory. Cloudflare Workers will use this information to build and deploy your application. We will cover how to find these values in the Netlify Dashboard below.

In your Netlify Dashboard, find the project you want to migrate to Workers. Go to the Project configuration menu for your specific project, then go into the Build & deploy menu item. You will find a Build settings card that includes the Build command and Publish directory fields. Save these for deploying to Cloudflare Workers. In the below image, the Build Command is npm run build, and the Output Directory is .next.

Finding the Build Command and publish Directory fields

Create a wrangler file

In the root of your project, create a wrangler.jsonc or wrangler.toml file (wrangler.jsonc is recommended). What goes in the file depends on what type of application you are deploying: an application powered by Static Site Generation (SSG), or a Single Page Application (SPA).

For each case, be sure to update the <your-project-name> value with the name of your project and <your-build-directory> value with the build directory from Netlify.

For a static site, you will need to add the following to your wrangler file.

{
  "name": "<your-project-name>",
  "compatibility_date": "2025-06-06",
  "assets": {
    "directory": "<your-build-directory>",
  }
}

For a Single Page Application, you will need to add the following to your Wrangler configuration file, which includes the not_found_handling field.

{
  "name": "<your-project-name>",
  "compatibility_date": "2025-04-23",
  "assets": {
    "directory": "<your-build-directory>",
    "not_found_handling": "single-page-application"
  }
}

Some frameworks provide specific guides for migrating to Cloudflare Workers. Please refer to our framework guides for more information. If your framework includes a “Deploy an existing project on Workers” guide, follow it for detailed instructions.

Create a new Workers project

Your application has the proper configuration to be built and deployed to Cloudflare Workers.

The Connect a new Worker guide will instruct you how to connect your GitHub project to Cloudflare Workers. In the configuration step, ensure your build command is the same as the command you found on Netlify. Also, the deploy command should be the default npx wrangler deploy.

Add a custom domain

Workers Custom Domains only supports domains that are configured as zones on your account. A zone refers to a domain (such as example.com) that Cloudflare manages for you, including its DNS and traffic.

Follow these instructions for adding a custom domain to your Workers project. You will also find additional information on creating a zone for your domain.

Delete your Netlify app

Once your custom domain is set up and sending requests to Cloudflare Workers, you can safely delete your Netlify application.

Troubleshooting

For additional migration instructions, review the Cloudflare Pages to Workers migration guide. While not Netlify specific, it does cover some additional steps that may be helpful.