Contentful logo

Contentful Community

Importing 100 entries of structured Content to a Contentful Model Programatically

Hello I am trying to do something very simple that would take many hours of manual work.
I am trying to upload all my json data to contentful!

The json data contains all the entries I want for a specific content model I already created. Image arrays, description, address etc.

I am trying to follow documentation

but lots of it is very unclear to me.
I have a very simple repo

I would like the JSON to me added as entries into a specific content model.
What kind of configuration am I missing in my config.js file?


Hi @arhoy,

Assuming I understood correctly… the import/export functionality in Contentful CLI is not able to import any JSON file. It can only import very specific JSON structure - namely JSON files, that were created by exporting a JSON file with Contentful CLI.

Having said that, it is possible to use any JSON file as a source and import it via Content Management API, but that requires some custom code and the Contentful Management API client for the language of your choosing.

I was actually working on this yesterday and struggled to find a lot of relevant info for a CSV import, but I was able to piece some stuff together. Here is an example of a simple JavaScript import I created to import from a CSV file. Hopefully this might help as a starting point to modify for importing from JSON.

const fs = require('fs');
const Parser = require('csv-parse');
const contentful = require('contentful-management');

const client = contentful.createClient({
  accessToken: '<token>',

async function main () {
  const space = await client.getSpace('<spaceId>')
  const environment = await space.getEnvironment('<envId>')
  const parser = new Parser({delimiter: ',', columns: true});
  const readStream = fs.createReadStream('./movies.csv').pipe(parser);

  for await (const chunk of readStream) {
    const entry = await rowToEntry(environment, chunk)

async function rowToEntry(env, row) {
  const date = new Date(row.Finished.replace('-', '/'))
  return await env.createEntry('movie', {
    fields: {
      title: {
        'en-US': row.Title
      dateCompleted: {
        'en-US': date.toISOString()
      expectedRating: {
        'en-US': parseInt(row.Expected)
      rating: {
        'en-US': parseInt(row['Rating (of 5)'])

1 Like

Interesting, thanks Blake, I did not know contentful supported CSV uploads.
I am just looking for a solution to upload entries into a content model. It has been a real struggle.

Sorry, to clarify, this was a script I wrote to read a local CSV file and create entries using the Content Management API. Contentful doesn’t support CSV or other uploads, as far as I’m aware, for importing content.

Sorry @arhoy I believe I misunderstood what you were initially asking about. If you are wanting to import

You would need to fill in your Contentful Space ID and create/add a management API key in your example-config.json. If the content model already exists, you can use the skip-content-model option:

contentful space import --config example-config.json --skip-content-model

Hey Guys, Apologies for jumping in here, Im trying to do something similar. Im trying to copy an Entry and all its nested children from one contentful space to another.

I have tried the Import/Export tool but it seems like it does not resolve nested entries.

@arhoy @blake.thompson Any idea how I can achieve this?

Thank you! Again apologies for jumping into your conversation.

I have no idea. I’ve gave up on ocntentful though atm and found wordpress way better and easier to use for cms for my purpose. It will always be free too

@syed.kazmi26 I don’t know for sure, but you might need to import the referenced entries first with the same IDs and then import the entry you wanted copy with the nested children.

@blake.thompson thank you for the reply,

oh you mean import the nested children entries first with the same ID’s and then import the parent entry in the end?

@syed.kazmi26 yes exactly, I would give that a shot!

Thanks Blake! Very helpful snippet.