schema rollback

Loads a changeset written by a previous schema push and reverts the Storyblok space to the state captured before that push. If you don’t pass a changeset-file, the command lists available changesets and prompts for one, unless --latest selects the most recent automatically.

Applying a rollback writes a new changeset that captures the rollback operation itself, letting you revert the rollback.

Prerequisites

The rollback requires a changeset file generated by a previous schema push.

Usage

storyblok schema rollback [changeset-file] [flags]

Arguments

Argument	Type	Description
Changeset file	string	Optional. Path to the changeset file to roll back to. Omit and pass --latest to pick one automatically.

Flags

Flag	Type	Description
--space, -s	integer	Required. The ID of the Storyblok space to roll back.
--path, -p	string	Optional. Base path of stored changesets.
--dry-run	boolean	Optional. Preview the rollback without applying changes.
--yes	boolean	Optional. Skip the interactive confirmation prompt.
--latest	boolean	Optional. Automatically select the most recent changeset.

Examples

The following examples assume you defined a space in the configuration file.

# Roll back the most recent push
storyblok schema rollback --latest

# Roll back to a specific changeset
storyblok schema rollback .storyblok/schema/changesets/2026-05-11T10-00-00Z.json

# Preview the rollback without applying changes
storyblok schema rollback --latest --dry-run