Convex Migrations — Online Data Migration Component

Batch-process existing documents to match new schema requirements — no downtime, resumable, state-tracked.

When to Use This

Use @convex-dev/migrations whenever you need to transform existing data in a Convex database — adding fields, renaming fields, converting types, backfilling computed values, or any bulk document update. Migrations run asynchronously in batches so the app stays available throughout.

Installation & Setup

npm install @convex-dev/migrations

Register the component

// convex/convex.config.ts
import { defineApp } from "convex/server";