# Inspect feature flag history with Vercel CLI

**Published:** July 23, 2026 | **Authors:** Chris Widmaier

---

![ Every revision of a flag with its author, message, timestamp, and changed environments.](//images.ctfassets.net/e5382hct74si/2f1Ob7zFgTjzqjIBOXbmeB/8cbaefe00dd09cda101f046df823d022/flag_version_history_light.png)
* Every revision of a flag with its author, message, timestamp, and changed environments.*

[Vercel Flags](https://vercel.com/docs/flags/vercel-flags) version history can now be inspected from the Vercel CLI with the new `vercel flags versions` command.

Run `vercel flags versions <flag>` to print the full revision history for a flag, with each revision's author, message, timestamp, and changed environments. Filter to a specific environment with `--environment`, paginate with `--limit` and `--cursor`, or add `--json` for scripting.

```bash
vercel flags versions my-flag
vercel flags versions my-flag --environment production
```

To compare a revision against the one before it, run `vercel flags versions diff <flag> --revision <n>`. The diff is semantic, surfacing field-level changes to targeting rules, rollout percentages, and conditions. Additions, removals, and modifications appear as colored `+`, `-`, and `~`.

```bash
vercel flags versions diff my-flag --revision 42
```

Update to the latest version of the Vercel CLI and learn more in the [Vercel Flags CLI documentation](https://vercel.com/docs/cli/flags#viewing-version-history) to get started.

---

📚 **More updates:** [View all changelog entries](/changelog/sitemap.md) | [Blog](/blog/sitemap.md)