Preview Deployment Suffix
When you create a new deployment, Vercel will automatically generate a unique URL which you can use to access that particular deployment.Preview Deployment Suffix is available on Pro and Enterprise plans
Preview Deployment Suffixes allow you to customize the URL of a preview deployment by replacing the default vercel.app suffix with a custom domain of your choice.
The entered custom domain must be:
- Available and active within the team that enabled the Preview Deployment Suffix
- Using Vercel's Nameservers
To enable Preview Deployment Suffix, and customize the appearance of any of your generated URLs:
- From your dashboard, select the Settings tab
- Select the Billing tab
- Under Add-Ons, set the toggle for Preview Deployment Suffix to Enabled
- Navigate to the Settings tab on the team dashboard
- Select the General tab and scroll down to the Preview Deployment Suffix section
- Enter the custom domain of your choice in the input, and push Save
If you are not able to use Vercel's Nameservers, see our guide on how to use a custom domain without Vercel's Nameservers.
See the plans add-ons documentation for information on pricing.
To disable Preview Deployment Suffix:
- From your dashboard, select the Settings tab
- Select the Billing tab
- 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.
You may encounter this error if you are using the 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
- Backed by an active wildcard certificate
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.
Was this helpful?