Was this article helpful?
Thanks for your feedback
After 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 you try the import commands, make sure you have unzipped the exported content from the folder that contains the exported content.
Content can be imported in a stack for the following modules:
Note: The imported content, in the target stack, will be automatically published to the environment and locale in which it was previously published in the source stack. If any exported content wasn’t published on any environment, that particular content won’t get published to any environment after it is imported into the target stack.
The cm:import command lets you import content to your destination stack. Below we have listed down the ways in which you can use the cm:import command:
Let's discuss in detail how you can import content in your stack.
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:import -a <management_token_alias>
Alternatively, refer the following command to add several parameters/options in a single line:
csdx cm:import -a <management_token_alias> -d <path_of_folder_where_content_is_stored>
Options
After importing the first module, note the name of the backup folder that was created in the workspace or in the code editor’s CLI folder.
Note: The parent backup folder created after the first import can be used to save all the backups in a single folder as it gets updated after every import operation.
When importing modules using the import command, provide the backup flag (b) along with the backup folder name as follows:
csdx cm:import -a <management_token_alias> -d <path_of_folder_where_content_is_stored> -m <module> -b <backup_dir>
Including the backup flag is essential when repeatedly using the single module import command. As these modules have inter-dependency, using the backup flag helps avoid any errors while importing.
For every module import 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 an efficient mapping.
Examples
Note: When importing modules individually, make sure you follow this module sequence: locales > environments > assets > extensions > webhooks > global-fields > content-types > workflows > entries > labels. For example, before importing entries, you must have had imported assets, environments, locales, extensions, webhooks, global-fields, content-types, and workflows.
This command lets you import content to your stack by using a management token and a configuration file that contains the parameters/options and their associated value.
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.
Doing so, you don’t need to separately provide parameters/options in the command.
Usage
csdx cm:import -a <management_token_alias> -c <config_file_path>
Options
Example
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
csdx cm:import -A
Alternatively, refer to the below command for adding several parameters/options in a single line:
csdx cm:import -A -s <stack_ApiKey> -d <path_of_folder_where_content_is_stored>
Options
After importing the first module, note the name of the backup folder that was created in the workspace or in the code editor’s CLI folder.
Note: The parent backup folder created after the first import can be used to save all the backups in a single folder as it gets updated after every import operation.
When importing modules using the import
command, provide the backup flag (b) along with the backup folder name as follows:
csdx cm:import -A -s <stack_ApiKey> -d <path_of_folder_where_content_is_stored> -m <module> -b <backup_dir>
Including the backup flag is essential when repeatedly using the single module import command. As these modules have inter-dependency, using the backup flag helps avoid any errors while importing.
For every module import 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 an efficient mapping.
Examples
Note: When importing modules individually, make sure you follow this module sequence: locales > environments > assets > extensions > webhooks > global-fields > content-types > workflows > entries > labels. For example, before importing entries, you must have had imported assets, environments, locales, extensions, webhooks, global-fields, content-types, and workflows.
This command lets you import content to your stack by using auth token and a configuration file that contains the parameters/options and its associated value.
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.
Doing so, you don’t need to separately provide parameters/options in the command.
Usage
csdx cm:import -A -c <config_file_path>
Options
Example
Additional Resources: Check out the Export Content documentation to learn how you can export content from your stack using CLI.
Was this article helpful?
Thanks for your feedback