If you’ve ever replatformed a site to a new CMS, you know that the hardest part is migrating the content.
That’s especially true when coming from WordPress, where the content is defined in a variety of ways, from Gutenberg blocks to Advanced Custom Fields to plain ol’ HTML when using the Classic Editor.
It can be done, but it’s tedious work, often involving compromises and data loss. So we decided to do something about it.
Today we’re excited to announce wp-import, a new CLI command that analyzes your WordPress content schema, replicates it within Craft, and then imports your WordPress content into Craft.
The command is incredibly full-featured: it imports users, posts, pages, categories, tags, media, custom post types, and custom taxonomies. Comments too, if Verbb Comments is installed.
It supports almost all ACF field types, including Google Map if Google Maps or Ether Maps are installed. It also features broad support for Gutenberg block types, which map to HTML and/or nested entries within a CKEditor field.
It’s a no-config way to move your whole site’s content into Craft, from a single command.
How to get it
The command is available as a Composer package, which can be added to any existing Craft CMS project running Craft 5.5 or later. The setup instructions will walk you through how to get it up and running.
See it in action
Brandon will be joining CraftQuest On Call tomorrow (14 November, 2024) at 1pm ET to demo the script and answer questions. If you’re interested in seeing the script in action or have any thoughts about it, be sure and tune in!
One more thing
Getting your content imported is well and good, but where do you go from there? Craft doesn’t have a theming layer or visual layout editor like you may be used to, and our first party craftcms/craft starter project doesn’t give you much to go on.
So we created a new starter project, built especially for WordPress developers, which offers a more familiar jumping-off point. It’s got Posts and Pages sections, a CKEditor field for body content, and commenting powered by Verbb Comments. Plus a fully-functioning front end powered by Twig templates.
We also published a new knowledge base article introducing core concepts and the Craft ecosystem, geared toward WordPress developers. It covers how to get up and running using our new WordPress starter, as well as how to import your content if you’re coming from an existing WordPress site.
If you’re new to Craft, we hope you’ll find these resources helpful! Please don’t be afraid to get in touch if you have any questions, or need additional help. That’s what we’re here for.
Happy migrating!