Skip to content

push

Terminal window
ctkit push

Reads every schema definition from your schemas/ directory, diffs them against the remote content model, and applies the changes directly to your Contentful space. Before applying, ctkit shows a summary of changes and asks for confirmation.

This command bypasses the migration system entirely — no migration files are generated or recorded.

Terminal window
ctkit push --dry-run

Shows what would change without applying anything to Contentful. Useful for reviewing the diff before committing to it.

+ blogPost (new content type)
~ author title: "Writer" → "Author"
= settings (no changes)
Terminal window
ctkit push --force

Skips the interactive confirmation prompt and applies changes immediately.

Terminal window
ctkit push schemas-v2/

Points ctkit at a different directory instead of the default schemas/.

FlagDescription
--dry-runPreview changes without applying them.
--forceSkip the confirmation prompt.
<schemas-dir>Path to a custom schemas directory (default: schemas/).

push is designed for rapid prototyping and early development — situations where you’re iterating quickly on your content model and don’t need a tracked migration history.

ScenarioRecommended command
Early development, solo work, throwaway environmentsctkit push
Team collaboration, production deployments, auditable historyctkit generate + ctkit migrate

Once your content model stabilizes and you start working with a team or deploying to production, switch to the generatemigrate workflow so changes are tracked, reviewable, and reproducible.

pushgenerate + migrate
Creates migration filesNoYes
Tracks execution historyNoYes
Reproducible across environmentsNoYes
SpeedFastestSlightly more steps
Best forPrototypingProduction