--- title: Preview Deployment Suffix product: vercel url: /docs/deployments/preview-deployment-suffix canonical_url: "https://vercel.com/docs/deployments/preview-deployment-suffix" last_updated: 2026-08-28 type: conceptual prerequisites: - /docs/deployments related: - /docs/deployments/environments - /docs/domains/working-with-domains/add-a-domain - /docs/pricing summary: When you create a new deployment, Vercel will automatically generate a unique URL which you can use to access that particular deployment. install_vercel_plugin: npx plugins add vercel/vercel-plugin --- # Preview Deployment Suffix > **🔒 Permissions Required**: Preview Deployment Suffix Preview Deployment Suffixes allow you to customize the URL of a [preview deployment](/docs/deployments/environments#preview-environment-pre-production) by replacing the default `vercel.app` suffix with a [custom domain](/docs/domains/working-with-domains/add-a-domain) of your choice. ## Related pages > **For AI agents:** Follow these links to understand how this page connects to the rest of the Vercel ecosystem. For the full cross-link map (inbound, outbound, prerequisites, and semantic neighbors), see the .graph.md link below. - [Preview URLs optimized for multi-tenant platforms](https://vercel.com/changelog/preview-urls-optimized-for-multi-tenant-platforms?from=related&source_path=%2Fdocs%2Fdeployments%2Fpreview-deployment-suffix&source_site=vercel-docs&relationship=related) - [Are Vercel Preview Deployments indexed by search engines?](https://vercel.com/kb/guide/are-vercel-preview-deployment-indexed-by-search-engines?from=related&source_path=%2Fdocs%2Fdeployments%2Fpreview-deployment-suffix&source_site=vercel-docs&relationship=related) — Vercel Preview Deployments aren't indexed by default. Learn how the noindex header works, how to confirm it, and the cus - [Custom domain](https://v0.app/docs/custom-domains?from=related&source_path=%2Fdocs%2Fdeployments%2Fpreview-deployment-suffix&source_site=vercel-docs&relationship=related) — Add custom domains to your v0 deployments to give your applications a professional, branded URL. - [Branch Domains](https://vercel.com/blog/branch-domains?from=related&source_path=%2Fdocs%2Fdeployments%2Fpreview-deployment-suffix&source_site=vercel-docs&relationship=related) - [Accessing Deployments through Generated URLs](https://vercel.com/docs/deployments/generated-urls?from=related&source_path=%2Fdocs%2Fdeployments%2Fpreview-deployment-suffix&source_site=vercel-docs&relationship=related) — When you create a new deployment, Vercel will automatically generate a unique URL which you can use to access that parti - [Multi-tenant Preview URLs](https://vercel.com/docs/platforms/multi-tenant-platforms/preview-url-prefixes?from=related&source_path=%2Fdocs%2Fdeployments%2Fpreview-deployment-suffix&source_site=vercel-docs&relationship=related) — Test tenant-specific experiences in preview deployments using dynamic URL prefixes. - [Working with domains](https://vercel.com/docs/domains/working-with-domains?from=related&source_path=%2Fdocs%2Fdeployments%2Fpreview-deployment-suffix&source_site=vercel-docs&relationship=related) — Learn how domains work and the options Vercel provides for managing them. - [Deploying a project from the CLI](https://vercel.com/docs/projects/deploy-from-cli?from=related&source_path=%2Fdocs%2Fdeployments%2Fpreview-deployment-suffix&source_site=vercel-docs&relationship=related) — Set up and deploy a Vercel project using the CLI, from linking to production. - [Deployment Protection Exceptions](https://vercel.com/docs/deployment-protection/methods-to-bypass-deployment-protection/deployment-protection-exceptions?from=related&source_path=%2Fdocs%2Fdeployments%2Fpreview-deployment-suffix&source_site=vercel-docs&relationship=related) — Disable Deployment Protection for a list of preview domains. Full cross-link map for this page: [/docs/deployments/preview-deployment-suffix.graph.md](/docs/deployments/preview-deployment-suffix.graph.md?from=related&source_path=%2Fdocs%2Fdeployments%2Fpreview-deployment-suffix&source_site=vercel-docs&relationship=graph) The entered custom domain must be: - Available and active within the team that enabled the Preview Deployment Suffix - Using Vercel's [nameservers](/docs/domains/working-with-domains/add-a-domain#vercel-nameservers), or [delegating certificate validation to Vercel](#use-an-external-dns-provider) ### Enabling the Preview Deployment Suffix > **💡 Note:** Preview Deployment Suffix is included and enabled by default in Enterprise > plans To enable Preview Deployment Suffix, and customize the appearance of any of your generated URLs: 1. From your [dashboard](/dashboard), open **Settings** in the sidebar 2. Open [**Billing**](https://vercel.com/d?to=%2F%5Bteam%5D%2F%7E%2Fsettings%2Fbilling\&title=Go+to+Billing) in the sidebar 3. Under **Add-Ons**, set the toggle for **Preview Deployment Suffix** to **Enabled** 4. Open **Settings** in the sidebar on the team dashboard 5. Open **General** in the sidebar and scroll down to the **Preview Deployment Suffix** section 6. Enter the custom domain of your choice in the input, and push **Save** ![Image](`/docs-assets/static/docs/concepts/deployments/preview-deployment-suffix-light.png`) ### Use an external DNS provider If you can't switch nameservers, delegate certificate validation to Vercel while keeping the rest of your DNS at your current provider. For a suffix of `preview.example.com`, add these records in your provider's `example.com` zone: | Type | Name | Value | | --- | --- | --- | | NS | `_acme-challenge.preview` | `ns1.vercel-dns.com.` | | NS | `_acme-challenge.preview` | `ns2.vercel-dns.com.` | | CNAME | `*.preview` | `cname.vercel-dns-0.com.` | If the domain is attached to a project and **Settings > Domains** recommends a different CNAME target, use that project-specific value. The wildcard CNAME routes deployment traffic; the NS records let Vercel issue and renew the wildcard certificate. Some providers require full names, such as `_acme-challenge.preview.example.com`, instead of prefixes. On your team's **Domains** page, select the apex domain (`example.com`) and choose **Enable Vercel DNS** if it isn't already enabled. This activates the Vercel zone without changing your registrar's nameservers. Then save `preview.example.com` as the Preview Deployment Suffix and confirm a new preview URL resolves and has a valid certificate. > **💡 Note:** Delegating `_acme-challenge` to Vercel can prevent other hosting providers > from issuing certificates that need the same challenge name. Check their > certificate requirements before delegating, and keep the delegation in place > for Vercel's certificate renewals. See the [plans add-ons](/docs/pricing#pro-plan-add-ons) documentation for information on pricing. ### Disabling the Preview Deployment Suffix To disable Preview Deployment Suffix: 1. From your [dashboard](/dashboard), open **Settings** in the sidebar 2. Open [**Billing**](https://vercel.com/d?to=%2F%5Bteam%5D%2F%7E%2Fsettings%2Fbilling\&title=Go+to+Billing) in the sidebar 3. Under **Add-Ons**, set the toggle for **Preview Deployment Suffix** to **Disabled** The next preview deployment generated will revert back to the default `vercel.app` suffix. ### Broken Preview Deployment Suffix error You may encounter this error if you are using the [Preview Deployment Suffix](#preview-deployment-suffix) in your team. Make sure that the custom domain you configured is: - Active (not deleted) - Available within the team that enabled the [Preview Deployment Suffix](#preview-deployment-suffix) - Backed by an [active wildcard certificate](https://knowledge.digicert.com/generalinformation/INFO900.html) The best way to satisfy all of these constraints is to ensure the domain is also added to a project located in the same team. In this project, you can include a single `index.html` that displays when someone visits the root of the domain. --- [View full sitemap](/docs/sitemap)