> ## Documentation Index
> Fetch the complete documentation index at: https://vlyai-1c28d863.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Rollback

> Instant rollback for production deployments. The escape hatch when something breaks.

When a production deploy turns out to be broken, roll back in seconds.

## How

<Steps>
  <Step title="Settings → Deployments">
    See the timeline of all production deploys.
  </Step>

  <Step title="Click any prior deploy → 'Rollback to here'">
    Confirm. Rollback executes in seconds.
  </Step>

  <Step title="Verify">
    Open production. The previous version should be live.
  </Step>
</Steps>

## What rollback does

* Reverts the **frontend** code to the previous deploy's bundle.
* Reverts the **Convex functions** (queries, mutations, actions).
* Does **NOT** revert schema migrations.

## Schema migration caveat

If the broken deploy added a `priority` field to `tasks`, rolling back leaves the field in the database but removes the code that uses it. The orphan field is harmless — old code paths don't reference it; new writes don't include it.

For destructive schema changes (renames, drops), rollback is more involved. vly will warn you when a rollback is "schema-incompatible" and walk through the cleanup.

To minimize this pain, **deploy schema changes separately from feature changes** when possible.

## Promotion via rollback

You can also "rollback forward" — promote any past production deploy back to current. Useful when:

* The current code is fine but data is wrong; restoring an old version doesn't help.
* A demo deploy was promoted by mistake; revert to last week's prod.

## Notifications

When a rollback happens, vly notifies the workspace owner via email. Audit log captures who did it and when.

## Related

<CardGroup cols={3}>
  <Card title="Version history" icon="history" href="/building/version-history">
    Code-level rollback (per revision).
  </Card>

  <Card title="Staging vs production" icon="git-branch" href="/deployment/staging-vs-production">
    Prevent issues from reaching prod.
  </Card>

  <Card title="Monitoring" icon="activity" href="/deployment/monitoring">
    Detect issues fast.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.