Frequently asked questions
Does the AI transform my content during the migration?
No. The AI guides the migration and runs trusted CLI commands, but the export, conversion, and import all run through deterministic tooling. Your content is never passed through a model and regenerated, which keeps the migration transparent and repeatable.
Can I run the migration without the AI skill?
Yes. The expert path uses the @contentstack/cli-external-migrate plugin directly. You can run the whole migration with migrate:create, or run migrate:export, migrate:convert, migrate:audit, and migrate:import as discrete steps. Both paths use the same tooling.
What does the migration not handle automatically?
Webhook secret values, publish rules, users and single sign-on configuration, and releases and scheduled actions need manual work. Webhook secrets are redacted by Contentful and cannot be read back, so you re-enter them by hand. Global fields are an optional content-modeling enhancement, not required for a one-to-one migration.
How long does a migration take?
On a clean starter project, the full content and code run finishes in under fifteen minutes. On a real space with several hundred entries and a DAM integration, the autonomous content run completes in roughly eight minutes. Code migration time depends on how complex your data layer is.
Is Contentful the only supported source?
Today, yes. Contentful is the only supported source. The architecture was built to add new sources by implementing an export adapter and a conversion adapter, so Sanity, Storyblok, and Strapi are planned next.
Frequently asked questions
Does the AI transform content during the migration?
No. The AI only guides the process and runs trusted CLI commands; export, conversion, and import use deterministic tooling and never regenerate your content.
Can the migration be run without the AI skill?
Yes. You can use the @contentstack/cli-external-migrate plugin directly via migrate:create or run migrate:export, migrate:convert, migrate:audit, and migrate:import as separate steps.
What parts of the migration are not handled automatically?
Webhook secret values, publish rules, users and SSO configuration, and releases and scheduled actions require manual work. Webhook secrets must be re-entered because they are redacted by Contentful.
How long does a migration take?
A clean starter project can complete in under 15 minutes. A real space with several hundred entries and a DAM integration can complete an autonomous content run in roughly 8 minutes; code migration time varies by data-layer complexity.
Is Contentful the only supported source?
Yes, currently only Contentful is supported. The architecture supports adding new sources via export and conversion adapters, with Sanity, Storyblok, and Strapi planned.