Preview Deployment Suffix

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:

1. From your dashboard, open Settings in the sidebar
2. Open 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

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:

1. From your dashboard, open Settings in the sidebar
2. Open 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.

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.