push
Push all schemas
Section titled “Push all schemas”ctkit pushReads 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.
Preview changes
Section titled “Preview changes”ctkit push --dry-runShows 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)Skip confirmation
Section titled “Skip confirmation”ctkit push --forceSkips the interactive confirmation prompt and applies changes immediately.
Custom schemas directory
Section titled “Custom schemas directory”ctkit push schemas-v2/Points ctkit at a different directory instead of the default schemas/.
| Flag | Description |
|---|---|
--dry-run | Preview changes without applying them. |
--force | Skip the confirmation prompt. |
<schemas-dir> | Path to a custom schemas directory (default: schemas/). |
When to use push
Section titled “When to use push”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.
| Scenario | Recommended command |
|---|---|
| Early development, solo work, throwaway environments | ctkit push |
| Team collaboration, production deployments, auditable history | ctkit generate + ctkit migrate |
Once your content model stabilizes and you start working with a team or deploying to production, switch to the generate → migrate workflow so changes are tracked, reviewable, and reproducible.
How it differs from generate + migrate
Section titled “How it differs from generate + migrate”push | generate + migrate | |
|---|---|---|
| Creates migration files | No | Yes |
| Tracks execution history | No | Yes |
| Reproducible across environments | No | Yes |
| Speed | Fastest | Slightly more steps |
| Best for | Prototyping | Production |