---
title: How to determine which Vercel Deployment introduced an issue?
description: Process to quickly determine when a deployment issue was introduced using the Vercel CLI
url: /kb/guide/how-to-determine-which-vercel-deployment-introduced-an-issue
canonical_url: "https://vercel.com/kb/guide/how-to-determine-which-vercel-deployment-introduced-an-issue"
published: 2025-11-03
last_updated: 2025-11-10
authors: Holden Altaffer
related:
  - /docs/cli/bisect
  - /docs/concepts/deployments/instant-rollback
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---
<!-- docsgraph:related -->
## 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.

- [Rollback Production](https://vercel.com/docs/deployments/rollback-production-deployment?from=related) — Recover from a bad production deployment by rolling back, investigating the root cause, and redeploying a fix.
- [Debug 500 Errors](https://vercel.com/docs/observability/debug-production-errors?from=related) — Find, fix, and verify production 500 errors using the Vercel CLI.
- [Deployments](https://vercel.com/docs/deployments?from=related) — Learn how to create and manage deployments on Vercel.
- [Managing Deployments](https://vercel.com/docs/deployments/managing-deployments?from=related) — Learn how to manage your current and previously deployed projects to Vercel through the dashboard. You can redeploy at a
- [Instant Rollback](https://vercel.com/docs/instant-rollback?from=related) — Learn how to perform an Instant Rollback on your production deployments and quickly roll back to a previously deployed p
- [Can you deploy based on tags/releases on Vercel?](https://vercel.com/kb/guide/can-you-deploy-based-on-tags-releases-on-vercel?from=related) — Learn how to deploy based on tags/releases on Vercel.
- [How to debug 404 errors](https://vercel.com/kb/guide/how-to-debug-404-errors?from=related) — Learn the systematic steps to identify and resolve 404 issues.

Full cross-link map for this page: [/kb/guide/how-to-determine-which-vercel-deployment-introduced-an-issue.graph.md](/kb/guide/how-to-determine-which-vercel-deployment-introduced-an-issue.graph.md)
<!-- /docsgraph:related -->


With Vercel Preview Deployments and [bisecting](https://vercel.com/docs/cli/bisect), you can quickly and efficiently determine which commit introduced a regression in your application, and then [instantly rollback](https://vercel.com/docs/concepts/deployments/instant-rollback).

[Watch a video tutorial](https://www.youtube.com/watch?v=6CTdji6s1GQ) or learn more in the following guide.

```bash
vercel bisect
```

## Use Vercel Bisect to find first broken deployment

Vercel Bisect is a command, inspired by the [git bisect](https://git-scm.com/docs/git-bisect) command, that helps identify the first Deployment an issue was introduced by traversing a range of preview deployments, marking them as either "good" or "bad". This tool was released in version 24 of the CLI.

To start your debugging session, run `vc bisect` in the terminal and you will be given an interactive prompt to help find where the bad commit was introduced. Start with a deployment URL where the bug occurs. Next, specify a deployment URL where the bug does _not_ occur. Lastly, specify a subpath to narrow down by page, such as `/login` or `/`.

Vercel Bisect will retrieve a list of deployments for you to review, starting in the middle of the list, utilizing a [Binary Search](https://en.wikipedia.org/wiki/Binary_search_algorithm). At each step, you’ll indicate if the deployment is “good” or “bad” to quickly narrow down to the root cause The number of steps left will be visible. After the full list of deployments has been traversed, the first bad deployment will be shown with the date, commit with message, and URL to inspect the deployment on the dashboard.

You can then [instantly rollback to a previous deployment](https://vercel.com/docs/concepts/deployments/instant-rollback) with Vercel.