From Contentful to DatoCMS

So 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.

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

Your Contentful Space ID

You can find it in Space settings > General settings:

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:

Your DatoCMS site full-access API token

You can find it under Settings > API tokens:

Install the tool using NPM:

npm install -g contentful-to-datocms

Run the following in the console:

contentful-to-datocms copy --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;
4. DatoCMS treats images and file attachments differently while Contentful has only the attachment type, so we try to infer the exact type using the validation rules present in a Contentful field. If the field accepts only image extensions or has a validation on image size it will be imported as an image, otherwise as an attachment.

Originally published at www.datocms.com.