Import to Kontent.ai

Import what makes sense

Avoid the fluff in your existing content and do a proper content audit before migrating. Not the one where you check just the broken links but the one where you make sure that your existing content isn’t ROT (redundant, outdated, and full of trivial content). Why would you import content no one needs? Check your web analytics to see your top content types and content items. Analyze how your current content serves these search queries and how it helps you achieve your goals. Another great activity is holding an internal content modeling workshop to see if your content model serves different channels, devices, and users. You might discover that you have great content for conversational interfaces, but you can’t use it because of the way it was modeled a few years back. Or that your content works well on a website but isn’t a good fit for voice interfaces or home assistants.

Ways to migrate content

Before you start the migration process, you might want to temporarily disable your webhooks. This way, you’ll avoid receiving a lot of unnecessary notifications. Once you're done importing, make sure to enable webhooks again.

Use migration tools

Importing to Kontent.ai can be done using one of the tools available for it. With Kontent.ai CLI, you can modify your Kontent.ai projects. This includes migrating existing content to Kontent.ai through the command line. You can also use it to modify your project’s content model. You use the CLI to run a series of migration scripts. Check how you can automate content migrations. With Kontent.ai data-ops tool, you can back up and restore your Kontent.ai data. This way, you can version your project’s environment and then import the previous version into an empty project if needed.

Migrate via API

For more complex migrations, use Management API. It gives you the flexibility of importing content with a more complicated structure and logic, which is typically the case when migrating higher volumes of content. Write a script or an application to parse the content from its original format and import it into Kontent.ai in JSON. The original content can be in any format, for example:

• A database from another CMS, such as WordPress
• An XML file
• A CSV file
• A text file

Learn the basics of using the API in our guide on importing content via API.