Import Contentful space into DatoCMS

Do you like DatoCMS but you created your project with Contentful? No problem, we released contentful-to-datocms, a Node.js-based CLI tool that copies all content from a Contentful space to a DatoCMS site.

What you will need

To copy your Contentful space to DatoCMS, you will need the following information:

  1. Your Contentful Space ID You can find it in Space settings > General settings:
Contentful space ID
  1. A Contentful Content management token

You can create one under Space settings > API keys > Content management tokens and then clicking the Generate personal token button:

Content management token
  1. Your DatoCMS site full-access API token

You can find it under Settings > API tokens:

DatoCMS site full-access API token


Install the tool using NPM:

npm install -g datocms-client

Run the following in the console:

dato contentful-import --contentfulSpaceId=<YOUR_CONTENTFUL_SPACE_ID> --contentfulToken=<YOUR_CONTENTFUL_API_TOKEN> --datoCmsToken=<YOUR_DATO_API_TOKEN>

Data Mapping

Although highly compatible, there are some minor differences between the types of fields that Contentful offers compared to DatoCMS, so the tool will follow the following migration rules:

  1. DatoCMS doesn't provide an array of strings field, so data of this kind will be converted in a single string field with comma separated values;
  2. Contentful API doesn't expose the presentation settings for fields, so all text fields will be set as Markdown editors (you will be able to change the presentation mode later from the DatoCMS interface);
  3. DatoCMS doesn't allow a long text field to be the Model title, so if that's the case no title field will be set;
Get started with DatoCMS now
No credit card required, 30 seconds sign-up
Try for free!