Storyblok CLI

The storyblok CLI scaffolds Storyblok projects and manages spaces from the terminal through the Management API.

Run storyblok --help to list commands, or storyblok <command> --help for one command.

Docs

SetupInstall the CLI and set defaults in storyblok.config.ts. Read once during setup, and again when the same flags repeat across commands.

Global optionsFlags every command accepts. Read when setting region, space, concurrency, or logging.

Commands

assets pullDownload assets, metadata, and folders to a local directory. Read when exporting assets from a space.

assets pushUpload assets from a directory, a local file, or a remote URL. Read when importing assets or syncing them between spaces.

components pullDownload component schemas, groups, presets, and tags. Read when exporting a component library.

components pushUpload component schemas, groups, presets, and tags. Read when applying a local component library to a space.

createScaffold a new project with your preferred technology. Read when starting a project from scratch.

datasources deleteDelete a datasource by name or ID. Read when removing a datasource from a space.

datasources pullDownload datasources and their entries. Read when exporting datasources.

datasources pushUpload datasources and their entries. Read when applying local datasources to a space.

languages pullDownload the languages configured in a space. Read when setting up internationalization locally.

loginAuthenticate with a password or a personal access token. Read when first authenticating, or when setting up CI.

logoutRemove stored credentials and end the session. Read when switching accounts.

logs listList the logs the CLI wrote per space. Read when diagnosing a past command.

logs pruneDelete old logs. Read when clearing local disk.

migrations generateCreate migration files for specific components. Read when starting a content migration.

migrations rollbackRevert a migration from its snapshot. Read when a migration produced the wrong result.

migrations runExecute migration files against stories. Read when applying a content migration.

reports listList the reports the CLI wrote per space. Read when reviewing the outcome of a past command.

reports pruneDelete old reports. Read when clearing local disk.

schema initWrite the current schema of a space as TypeScript files. Read when adopting a code-defined schema.

schema pushDiff a local schema against a space and apply the changes. Read when deploying schema changes.

schema rollbackRevert a space to the state captured before a push. Read when a schema push went wrong.

schema validateCheck a local schema for structural problems. Read when verifying a schema before pushing it.

signupOpen the signup page in the browser. Read when creating a first account.

stories pullDownload stories to a local directory. Read when exporting content.

stories pushUpload stories from a local directory. Read when importing content or syncing between spaces.

stories validateCheck every story in a space against a local schema. Read when auditing content against a schema.

types generateGenerate TypeScript definitions from pulled components. Read when typing Storyblok content in a project.

userShow the authenticated account and its region. Read when checking which account is active.