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. Log in to the Cloudflare dashboard ↗ and select your account.
  2. Select Workers & Pages.
  3. 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.

Disabling workers.dev

Review your workers.dev route in your Worker > Settings > Domains & Routes.

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

workers_dev = false

When you redeploy your Worker with this change, the workers.dev route will be disabled. Disabling your workers.dev subdomain will also make preview URLs inaccessible.

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

Limitations

  • You cannot currently secure workers.dev URLs behind Cloudflare Access. This is a temporary limitation, we are working to remove it.
Cloudflare DashboardDiscordCommunityLearning CenterSupport Portal
Cookie Settings