sb-mig documentation

sb-mig is a command line toolkit for Storyblok teams that want schema and content operations to be reviewable, repeatable, and inspectable.

It started as a code-first Storyblok component sync tool. It now covers component schemas, roles, datasources, plugins, stories, assets, backups, content migrations, preset migrations, publication-state inspection, and migration audit artifacts.

Why teams use it

• Keep Storyblok component schemas in code.
• Sync local schema files into Storyblok spaces.
• Move stories and assets between spaces or files.
• Run scripted content migrations over Storyblok story JSON.
• Preserve published and draft layers during sensitive migrations.
• Generate dry-run evidence before writing to Storyblok.
• Find rare component usage patterns across many stories with read-only query files.
• Keep migration output auditable with JSON and JSONL artifacts.

Current center of gravity

The most important workflow in sb-mig 6.x is safe content migration:

sb-mig migrate content --all \
  --from 12345 \
  --to 12345 \
  --migration migration-name \
  --publicationMode preserve-layers \
  --dry-run \
  --fileName production-check

That command previews the selected stories, applies the migration in memory, writes local artifacts, and makes no Storyblok writes.

What to read first

• Quickstart for installation and config.
• Safe content migration for the production workflow.
• CLI reference for command families.
• Publication model for the reason behind preserve-layers.