Contentful provides a content infrastructure for digital teams to power content in websites, apps, and devices. Unlike a CMS, Contentful was built to integrate with the modern software stack. It offers a central hub for structured content, powerful management and delivery APIs, and a customizable web app that enable developers and content creators to ship digital products faster.
This library helps you to import files generated by contentful-export to a destination space.
We moved the CLI version of this tool into our Contentful CLI. This allows our users to use and install only one single CLI tool to get the full Contentful experience.
Please have a look at the Contentful CLI import command documentation to learn more about how to use this as command line tool.
npm install contentful-import
const contentfulImport = require('contentful-import')
const options = {
content: {entries:..., contentTypes:..., locales:...},
spaceId: '<space_id>',
managementToken: '<content_management_api_key>',
...
}
contentfulImport(options)
.then(() => {
console.log('Data imported successfully')
})
.catch((err) => {
console.log('Oh no! Some errors occurred!', err)
})
or
const contentfulImport = require('contentful-import')
const options = {
contentFile: '/path/to/result/of/contentful-export.json',
spaceId: '<space_id>',
managementToken: '<content_management_api_key>',
...
}
contentfulImport(options)
.then(() => {
console.log('Data imported successfully')
})
.catch((err) => {
console.log('Oh no! Some errors occurred!', err)
})
const contentfulImport = require('contentful-import')
const options = {
contentFile: '/path/to/result/of/contentful-export.json',
spaceId: '<space_id>',
managementToken: '<content_management_api_key>',
environmentId: '<environment_id>',
...
}
contentfulImport(options)
...
ID of the space to import into
ID of the environment in the destination space
Contentful management API token for the space to be imported to
Path to JSON file that contains data to be import to your space
Content to import. Needs to match the expected structure (See below)
Import content types only
Skip importing of content types and locales
Skip importing of locales
Skips content publishing. Creates content but does not publish it
The Management API host
Proxy configuration in HTTP auth format: host:port
or user:password@host:port
Pass proxy config to Axios instead of creating a custom httpsAgent
Full path to the error log file
Display progress in new lines instead of displaying a busy spinner and the status in the same line. Useful for CI.
- Unable to connect to Contentful through your Proxy? Try to set the
rawProxy
option totrue
.
contentfulImport({
proxy: 'https://cat:[email protected]:1234',
rawProxy: true,
...
})
The data to import should be structured like this:
{
"contentTypes": [],
"entries": [],
"assets": [],
"locales": [],
"webhooks": [],
"roles": [],
"editorInterfaces": []
}
- Both source space and destination space must share the same content model structure. In order to achieve that, please use the migration-cli.
- Content transformations are also not supported, please use the migration-cli.
- Entities existence are determined based on their ID:
- If an entity does not exist in the destination space, it will be created.
- If an entity already exists in the destination space, it will be updated.
- Publishing strategy:
- If an entity is in draft, it will be created as draft in the destination space.
- If an entity is published and has pending changes (updated) in the source space, it will be published with the latest changes in the destination space.
- This tool currently does not support the import of space memberships.
- This tool currently does not support the import of roles.
- This tool is expecting the target space to have the same default locale as your previously exported space.
- Imported webhooks with credentials will be imported as normal webhooks. Credentials should be added manually afterwards.
- If you have custom UI extensions, you need to reinstall them manually in the new space.
Read the releases page for more information.
This project is licensed under MIT license