Custom domains (4)

Last updated Sep 24, 2026 Preview URLs can use a custom domain, workers.dev, or both. Enable at least one host to get a Preview URL.

Before you start

Configure Previews in the same system that manages your custom domain:

Enable custom domain Preview URLs

The following example configures app.example.com for Preview traffic only. Add previews_enabled and set enabled to false, then run npx wrangler deploy to apply the configuration.

{
  "routes": [
    {
      "pattern": "app.example.com",
      "custom_domain": true,
      "previews_enabled": true,
      "enabled": false
    }
  ]
}

[[routes]]
pattern = "app.example.com"
custom_domain = true
previews_enabled = true
enabled = false

Choose which traffic the custom domain serves:

1. In the Cloudflare dashboard, go to Workers & Pages and select your Worker. Go to Workers & Pages ↗
2. On the Domains tab, under Custom Domains and Routes, select + Add Domain.
3. Enter your domain. For Enable for, select Preview or Production and Preview. Then select Add domain.
4. Confirm that the domain appears under Custom Domains and Routes.

<details>

<summary>

DNS and certificate behavior

</summary>

Cloudflare creates a wildcard DNS record and SSL certificate for the custom domain, such as <code>*.app.example.com</code>. Certificate issuance can take time after you create the first Preview.

Use a dedicated hostname such as <code>previews.example.com</code> if your production domain already has subdomains. This avoids wildcard conflicts.

Preview URLs add another subdomain to your hostname. For example, <code>app.preview.example.com</code> creates <code><preview-name>.app.preview.example.com</code>. For deeper hostnames, you may need <a href="https://developers.cloudflare.com/ssl/edge-certificates/advanced-certificate-manager/">Advanced Certificate Manager</a> with <a href="https://developers.cloudflare.com/ssl/edge-certificates/additional-options/total-tls/">Total TLS</a> or another certificate that covers the Preview hostname.

</details>

Enable workers.dev Preview URLs

Production and Preview workers.dev URLs are configured separately.

Set preview_urls in your Wrangler configuration file, then run npx wrangler deploy.

{
  "preview_urls": true
}

preview_urls = true

If preview_urls is omitted, Wrangler does not change an existing Preview URL setting. If no setting exists, its initial value depends on workers_dev. Set preview_urls explicitly to change the Preview URL setting.

1. In the Cloudflare dashboard, go to Workers & Pages and select your Worker. Go to Workers & Pages ↗
2. On the Domains tab, under Worker URL, turn on Preview.

Protect Preview content

To restrict access to custom domain and workers.dev Preview URLs, use Cloudflare Access. This prevents unauthenticated users and crawlers from viewing your Preview.

To keep a Preview public while discouraging search engine indexing, add an X-Robots-Tag: noindex response header. Cloudflare adds this header automatically to workers.dev Preview URLs, but not to custom domain Preview URLs.

For static assets, add the header through a _headers file. For Worker-generated responses, add it directly in your Worker code.

Was this helpful?

YesNo

On this page

Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/previews/custom-domains/#page","headline":"Custom domains","description":"Serve Preview URLs from custom domains and protect them with Cloudflare Access.","url":"https://developers.cloudflare.com/workers/previews/custom-domains/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/previews/custom-domains/og.png?v=9983358f175f5b1c","dateModified":"2026-09-24","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: Create Previews from Workers Builds, GitHub Actions, or another CI system. title: Examples image: https://developers.cloudflare.com/workers/previews/examples/og.png?v=e7b4e199277c303d

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.