Import Content using the CLI

Once you have exported the content from the source stack, the next step is to import it into the destination stack. To do this, you can use the import command in several ways.

Note: Before using the import command, make sure you have successfully unzipped the exported content located within the corresponding folder.

Content can be imported into a stack for the following modules:

• Assets
• Locales
• Environments
• Extensions
• Marketplace Apps
• Webhooks
• Global Fields (CLI supports Nested Global Fields from v1.42.0)
• Content Types
• Entries
• Labels
• Workflow
• Custom Role
• Taxonomy

Note: Imported content will be published to the same environment and locale as in the source stack. Unpublished content in the source stack will remain unpublished after import.

Prerequisites

• Contentstack account
• CLI installed 
• A configured management token (alias) or authtoken

Commands

The cm:stacks:import command lets you import content into your destination stack.

Below we have listed down different ways in which you can use the cm:stacks:import command:

• Import Content Using Management Token and Parameters
• Import Content Using Management Token and Config file
• Import Content Using Auth Token and Parameters
• Import Content Using Auth Token and Config file

Let's discuss how you can import content into your stack in detail.

Note: If the export folder has branches, the path or location in your file system where you intend to import the content should point till the particular branch folder (absolute path). For example, -d "C:\Users\Name\Desktop\cli\content\branch_name".

Import Content Using Management Token and Parameters

This command lets you import content using a management token. For ease, you can pass several parameters/options to this command at once.

Usage

csdx cm:stacks:import -a <<alias>>

Alternatively, refer to the following command to add several parameters/options in a single line:

csdx cm:stacks:import -a <<alias>> -d <<path_of_folder_where_content_is_stored>> 

Options

• -c, --config=config: [optional] The path of the configuration JSON file containing all the options for a single run.
• -k, --stack-api-key=stack-api-key: API Key of the target stack.
• -a, --alias: The management token of the destination stack where you will import the content.
• -d, --data-dir=data-dir: The path or the location in your file system where the content, you intend to import, is stored. For example, -d "C:\Users\Name\Desktop\cli\content". If the export folder has branches involved, then the path should point till the particular branch. For example, -d "C:\Users\Name\Desktop\cli\content\branch_name".
• --branch=branch: The name of the branch where you want to import your content. If you don’t mention the branch name, then by default the content will be imported to the main branch.
• --exclude-global-modules: Excludes the branch-independent module from the import operation.
• --module=module: (optional) Specify the module to import into the target stack. If not specified, the import command will import all the modules into the stack. The available modules are assets, content-types, entries, environments, extensions, marketplace-apps, global-fields, labels, locales, webhooks, custom-roles, workflows and taxonomies.
• --backup-dir=backup-dir : (optional) Backup directory name when using a specific module.
• --import-webhook-status=<option>: [default: disable] This webhook state maintains the same configuration as the source stack. <options: disable|current>
• --skip-audit: (optional) Skips the audit fix that occurs during an import operation.
• --skip-app-recreation: (optional) Skips the recreation of private apps if they already exist.
• --skip-assets-publish: Skips asset publishing during the import process.
• --skip-entries-publish: Skips entry publishing during the import process.
• -y, --yes: Force override all Marketplace prompts.
  Note:

  • If the --yes flag is not passed, you are prompted to enter an encryption key while importing the Marketplace App for the app configurations. You have 3 attempts to enter the correct encryption key for the Marketplace App configurations while using the import command. You must start the import process from the beginning after 3 failed attempts.
  • If the --skip-audit flag is not used, the audit step will remove all branches from the workflow module except the one currently in use. For example, when importing data from a stack that has three branches (main, development, production) using the Import command with the branch name specified as development, then the audit command will remove the main and production branches from the workflow module for a successful import.

Import Content Using Management Token and Config file

This command lets you import content to your stack by using a management token and a configuration file that contains the parameters/options and the associated values.

To get started with this command, download this config file, add values to this file, and note down the path where you have saved this file.

By doing so, you don’t need to separately provide parameters/options in the command.

Usage

 csdx cm:stacks:import -a <<alias>> -c <<config_file_path>>

Options

• -a, --alias: The management token of the destination stack where you will import the content.
• -c, --config=config: The path of the configuration JSON file containing all the options for a single run. You can refer to this example config file.

Example

• To import content using a config file:
  
  csdx cm:stacks:import -a mytoken -c “C:\Users\Name\Desktop\cli\config.json”

Import Content Using Auth Token and Parameters

You can use this method to import content to your stack if you have logged in to the session using the Login command. Running the Login command generates an auth token, which is used in the command below.

Usage

Refer to the command below to add several parameters/options in a single line:

csdx cm:stacks:import -k <<stack_ApiKey>> -d <<path_of_folder_where_content_is_stored>>

Note: If the management token is not specified, by default import command uses Auth token.

Options

• -k, --stack-api-key=stack-api-key: API Key of the target stack.
• -d, --data-dir=data-dir: The path or the location in your file system where the content, you intend to import, is stored. For example, -d "C:\Users\Name\Desktop\cli\content". If the export folder has branches involved, then the path should point till the particular branch. For example, -d "C:\Users\Name\Desktop\cli\content\branch_name".
• --branch=branch: The name of the branch where you want to import your content. If you don’t mention the branch name, then by default the content will be imported to the main branch.
• --exclude-global-modules: Excludes the branch-independent module from the import operation.
• --module=module: (optional) Specify the module to import into the target stack. If not specified, the import command will import all the modules into the stack. The available modules are assets, content-types, entries, environments, extensions, marketplace-apps, global-fields, labels, locales, webhooks, custom-roles, workflows, and taxonomies.
• --skip-audit: (optional) Skips the audit fix that occurs during an import operation.
• --skip-app-recreation: (optional) Skips the recreation of private apps if they already exist.
• --skip-assets-publish: Skips asset publishing during the import process.
• --skip-entries-publish: Skips entry publishing during the import process.
• -y, --yes: Force override all Marketplace prompts.

  Note: If the --yes flag is not passed, you are prompted to enter an encryption key while importing the Marketplace App for the app configurations. You have 3 attempts to enter the correct encryption key for the Marketplace App configurations while using the import command. You must start the import process from the beginning after 3 failed attempts.

Import Content Using Auth Token and Config file

This command lets you import content to your stack by using auth token and a configuration file that contains the parameters/options and the associated values.

To get started with this command, download this config file, add values to this file, and note down the path where you have saved this file.

By doing so, you don’t need to separately provide parameters/ options in the command.

Usage

csdx cm:stacks:import -c <<config_file_path>> 

Options

• -c, --config: The path of the configuration JSON file containing all the options for a single run. You can refer to this example config file.
• --skip-app-recreation: (optional) Skips the recreation of private apps if they already exist.

Example

• To import content using a config file:
  
  csdx cm:stacks:import -c “C:\Users\Name\Desktop\cli\config.json”

Support for Marketplace Apps

You can import public and private Marketplace Apps to a stack using CLI commands.

Public apps:

If an app with a configuration already exists in the destination organization, then while importing it from one organization to another, you can:

• Update it with the new app configuration.
• Skip updating the configuration (If you do not update the configuration, there may be some issues with the content which you import).
• Exit to cancel the entire stack import process.

Private apps:

1. If the imported app has the same name as any existing apps in the destination, you will be prompted to change the name of the imported app.

   Note: The app name must be 3-20 characters long.

2. During the stack import process, if you acknowledge and confirm, the listed private app(s) will be re-created and installed.
3. If you cancel the app re-creation, it may break the import process of entries/content types/global fields.
4. If you want to skip the recreation of private apps if they already exist, provide the skip-app-recreation flag.
   csdx cm:stack:import -k <<stack_ApiKey>> -d <<path_of_folder_where_content_is_stored>> --skip-app-recreation --yes

Support for Variants

If the content you're importing is associated or synced with a Personalize project, a new Personalize project will be created and linked to the new stack. Additionally, the items below will be imported into the target stack:

• The following modules within the Personalize project:
  • Experiences
  • Audience
  • Attributes
  • Events
• Entry Variants (imported into the stack as part of entries)

Options

• --personalize-project-name: (optional) Provide a unique name for the Personalize project.

Note: Variants and Personalize currently only support basic authentication.

Variants Limitation

The -a <alias> flag skips Personalize modules, as they require authentication tokens for import and cannot be imported using management tokens.

Module-wise Import

The --module flag in the import command allows module-specific imports into the target stack. Specify a module to import only that module. To import all modules, avoid using the flag. Available modules include assets, content-types, entries, environments, extensions, marketplace-apps, global-fields, labels, locales, webhooks, workflows, custom-roles, and taxonomies. This feature enhances control and efficiency in managing stack data.

csdx cm:stacks:import -k bltxxxxxx -d "C:\Users\Name\Desktop\cli\content" --module locales

Including the backup flag is essential when repeatedly using the single module import command. Due to module inter-dependencies, the backup flag helps avoid import errors.

csdx cm:stacks:import -k <<stack_ApiKey>> -d <<path_of_folder_where_content_is_stored>> --module <<module>> --backup-dir <<backup_dir>>

For every import module operation, all the latest mapping files are added to a single mapper folder, and the dependent modules use the latest UIDs of the dependency for efficient mapping.

Examples

• To import assets into a stack:
  csdx cm:stacks:import -k bltxxxxxx -d "C:\Users\Name\Desktop\cli\content" -m assets

• To import entries into a stack:
  csdx cm:stacks:import -k bltxxxxxx -d "C:\Users\Name\Desktop\cli\content" -m entries --backup-dir <<backup_dir>>

Note: The parent backup folder created during the initial import can be reused for subsequent module imports. To ensure a smooth import process, always provide this backup folder when importing modules individually.

Import Overwrite Feature

The Overwrite feature in the import command enhances the import process by allowing you to seamlessly update the existing content within a stack. By using this feature, you can prevent an import failure if an imported module already exists in the target stack.

Limitations

• The import command will import only the latest version of a published entry/asset.
• While importing workflows from one stack to another, admins and workflow stage users are not included. Therefore, admins and stage users of your workflows will not be migrated to the new stack.
• Currently, you cannot import content for the following modules:
  • Users
  • Releases

Additional Resources: Check out the Export Content documentation to learn how you can export content from your stack using CLI.