Skip to content
Cloudflare Docs

workers.dev

Cloudflare Workers accounts come with a workers.dev subdomain that is configurable in the Cloudflare dashboard. Your workers.dev subdomain allows you getting started quickly by deploying Workers without first onboarding your custom domain to Cloudflare.

It's recommended to run production Workers on a Workers route or custom domain, rather than on your workers.dev subdomain. Your workers.dev subdomain is treated as a Free website ↗ and is intended for personal or hobby projects that aren't business-critical.

Configure workers.dev

workers.dev subdomains take the format: <YOUR_ACCOUNT_SUBDOMAIN>.workers.dev. To change your workers.dev subdomain:

  1. In the Cloudflare dashboard, go to the Workers & Pages page.

    Go to Workers & Pages

  2. Select Change next to Your subdomain.

All Workers are assigned a workers.dev route when they are created or renamed following the syntax <YOUR_WORKER_NAME>.<YOUR_SUBDOMAIN>.workers.dev. The name field in your Worker configuration is used as the subdomain for the deployed Worker.

Manage access to workers.dev

When enabled, your workers.dev URL is available publicly. You can use Cloudflare Access to require visitors to authenticate before accessing preview URLs. You can limit access to yourself, your teammates, your organization, or anyone else you specify in your access policy.

To limit your workers.dev URL to authorized emails only:

  1. In the Cloudflare dashboard, go to the Workers & Pages page.

    Go to Workers & Pages

  2. In Overview, select your Worker.

  3. Go to Settings > Domains & Routes.

  4. For workers.dev, click Enable Cloudflare Access.

  5. Optionally, to configure the Access application, click Manage Cloudflare Access. There, you can change the email addresses you want to authorize. View Access policies to learn about configuring alternate rules.

  6. Validate the Access JWT ↗ in your Worker script using the audience (aud) tag and JWKs URL provided.

Disabling workers.dev

Disabling workers.dev in the dashboard

To disable the workers.dev route for a Worker:

  1. In the Cloudflare dashboard, go to the Workers & Pages page.

    Go to Workers & Pages

  2. In Overview, select your Worker.

  3. Go to Settings > Domains & Routes.

  4. On workers.dev click "Disable".

  5. Confirm you want to disable.

Disabling workers.dev in the Wrangler configuration file

To disable the workers.dev route for a Worker, include the following in your Worker's Wrangler configuration file:

{
  "workers_dev": false
}

When you redeploy your Worker with this change, the workers.dev route will be disabled. Disabling your workers.dev route does not disable Preview URLs. Learn how to disable Preview URLs.

If you do not specify workers_dev = false but add a routes component to your Wrangler configuration file, the value of workers_dev will be inferred as false on the next deploy.