The Vercel dashboard lets you manage all your current and previous deployments. To manage a deployment, go to your project from the Vercel dashboard. Then click the Deployments tab from the top navigation.
Vercel CLI and Vercel API also provide alternative ways to manage your deployments. You can find a full list of the commands available in the Vercel CLI Reference, along with the deployments section of the Vercel API Reference.
You can filter your deployments based on branch and status. Go to the Deployments tab inside your Project dashboard. A drop-down for Status filters the deployments according to the desired status code.
These are the following Status values:
- Ready: A successful deployment
- Error: An unsuccessful or failed deployment
- Building: A deployment currently being built
- Queued: A deployment waiting to be built
- Canceled: A deployment that was canceled
You will also find a drop-down search menu with a placeholder text for "All Branches". This helps you select any deployed branch from the drop-down or filter by typing in the search box.
When you update your Project, Vercel automatically redeploys your application to integrate new and existing changes. You update an application by editing, adding, or deleting its contents.
However, there can be situations (e.g. bad cached data) where you need to Redeploy your application to fix issues manually. This section contains information about how and when you need to redeploy your application to Vercel.
The Deployments tab lists all the previously deployed builds. Click the vertical ellipsis (⋮) icon where you will find the option to Redeploy that specific build once again.
This takes you to a popup window that prompts a Redeploy message. To surface the default behavior and provide granular control, you can now find an option for including the Build Cache when redeploying an existing Deployment.
Other than your custom needs to redeploy, it's always recommended to redeploy your application to Vercel for the following use cases:
- Enabling the Analytics
- Changing the Environment Variables
- Outage Resiliency
- Making changes to Build & Development Settings
- Redirect or Rewrites from a subdomain to a subpath
If you no longer need a specific deployment of your app, you can delete it from your project. Click the vertical ellipsis for the deployment you want to delete from the Deployments tab. Then click the Inspect Deployment option, which directs you to the details of that deployment.
From here, you can Delete the deployment. However, deleting a deployment prevents you from instant reverting and might break the links used in integrations, such as the ones in the pull requests of your Git provider.