--- title: "[Contentstack Command-line Interface (CLI)] - Bulk Publish and Unpublish Content | Old Commands" description: Bulk Publish and Unpublish Content | Old Commands url: https://www.contentstack.com/docs/developers/cli/bulk-publish-and-unpublish-content/old-commands product: Contentstack doc_type: cli-guide audience: - developers version: old-commands last_updated: 2026-03-25 --- # [Contentstack Command-line Interface (CLI)] - Bulk Publish and Unpublish Content | Old Commands This page describes the Contentstack CLI bulk publish and unpublish commands (old commands), including prerequisites, usage, options, configuration file generation, and limitations. It is intended for developers using the Contentstack CLI to publish/unpublish entries and assets across environments/locales, especially when automating or running bulk operations. ## Bulk Publish and Unpublish Content | Old Commands The Bulk Publish and Unpublish commands allow you to publish entries and assets from multiple content types to one or more environments. ## Prerequisites - [Contentstack account](https://www.contentstack.com/login) - CLI [installed](/docs/developers/cli/install-the-cli) on your machine - [Authentication](https://www.contentstack.com/docs/developers/cli/authenticate-with-the-cli/) to use CLI - A [configured management token](/docs/developers/cli/authenticate-with-the-cli#add-token) ## Commands To perform bulk publish and unpublish operations on entries and assets, there are a series of commands that you need to run in the CLI. Let's discuss them in detail. ### Bulk Publish All Entries The `**cm:bulk-publish:entries**` command lets you publish multiple entries on multiple environments for specific locales. **Usage** ``` csdx cm:bulk-publish:entries -t -l -e ``` **Note**: To avoid bulk publish failure, we recommend you to bulk publish content of one content type at a time. **Options** - `-t`,` --contentTypes=contentTypes`: The UID of the content type(s) whose entries you want to publish in bulk. In case of multiple content types, specify the IDs separated by spaces. - `-l`, `--locales=locales`: Locales in which entries will be published, e.g., *en-us*. In the case of multiple locales, specify the codes separated by spaces. - `-e`, `--environments=environments`: The name of the environment on which entries will be published. In case of multiple environments, specify their names separated by spaces. - `-a`, `--alias=alias`: Alias (name) of the management token. - `-B`, `--branch=branch`: The name of the branch where you want to perform the bulk publish operation. If you don’t mention the branch name, then by default the content from the **main** branch will be published. - `-o`, `--publishAllContentTypes`: *(optional)* Set it to **true **to bulk publish entries from all content types. If the **contentTypes** option is already used, then you cannot use this option. - `-b`, `--[no-]bulkPublish=bulkPublish`: Set this flag to use Contentstack’s Bulk Publish APIs. It is **true, **by default. - `-r`, `--retryFailed=retryFailed`: *(optional)* Use this option to retry publishing the failed entries/assets from the logfile. Specify the name of the logfile that lists failed publish calls. If this option is used, it will override all other flags. - `-y`, `--yes`: Set it to **true **to process the command with the current configuration. - `-c`, `--config=config`: *(optional) *The path of the optional configuration JSON file containing all the options for a single run. Refer to the [**configure**](#build-the-configuration-file) command to create a configuration file. ### Bulk Publish Edited Entries The `**cm:bulk-publish:entry-edits**` command lets you publish recently edited entries on a particular environment. **Usage** ``` csdx cm:bulk-publish:entry-edits -t -s -e -l ``` **Options** - `-t`, `--contentTypes=contentTypes`: The UID of the content type(s) whose edited entries you want to publish in bulk. In case of multiple content types, specify the IDs separated by spaces. - `-s`, `--sourceEnv=sourceEnv`: The name of the source environment where the entries were initially published. - `-e`, `--environments=environments`: The name of the environment(s) on which the entries will be published. In case of multiple environments, specify their names separated by spaces. - `-l`, `--locales=locales`: Locales in which entries will be published, e.g., *en-us*. In the case of multiple locales, specify the codes separated by spaces. - `-a`, `--alias=alias`: Alias (name) of the management token. - `-B`, `--branch=branch`: The name of the branch where you want to perform the bulk publish operation. If you don’t mention the branch name, then by default the entries from the **main** branch will be published. - `-b`, `--[no-]bulkPublish=bulkPublish`: Set this flag to use Contentstack’s Bulk Publish APIs. It is **true, **by default. - `-r`, `--retryFailed=retryFailed`: *(optional) *Use this option to retry publishing the failed entries/assets from the logfile. Specify the name of the logfile that lists failed publish calls. If this option is used, it will override all other flags. - `-y`, `--yes`: Set it to **true **to process the command with the current configuration. - `-c`, `--config=config`: *(optional)* The path of the optional configuration JSON file containing all the options for a single run. Refer to the [**configure**](#build-the-configuration-file) command to create a configuration file. ### Bulk Publish Draft Entries The `**cm:bulk-publish:unpublished-entries**` command lets you publish the unpublished or draft entries on any environment(s). **Usage** ``` csdx cm:bulk-publish:unpublished-entries -t -s -e -l ``` **Options** - `-t`, `--contentTypes=contentTypes`: The UID of the content type(s) whose entries you want to publish in bulk. In case of multiple content types, specify their IDs separated by spaces. - `-s`, `--sourceEnv=sourceEnv`: The name of the source environment where the entries were initially published. - `-e`, `--environments=environments`: The name of the environment on which entries will be published. In case of multiple environments, specify their names separated by spaces. - `-l`, `--locale=locale`: Locale in which entries will be published, e.g., *en-us.* - `-a`, `--alias=alias`: Alias (name) of the management token. - `-B`, `--branch=branch`: The name of the branch where you want to perform the bulk publish operation. If you don’t mention the branch name, then by default the entries from **main** branch will be published. - `-b`, `--[no-]bulkPublish=bulkPublish`: Set this flag to use Contentstack’s Bulk Publish APIs. It is **true, **by default. - `-r`, `--retryFailed=retryFailed`: *(optional) *Use this option to retry publishing the failed entries from the logfile. It is optional. Specify the name of the logfile that lists failed publish calls. If this option is used, it will override all other flags. - `-y`, `--yes`: Set it to **true **to process the command with the current configuration. - `-c`, `--config=config`: *(optional) * The path of the optional configuration JSON file containing all the options for a single run. Refer to the [**configure**](#build-the-configuration-file) command to create a configuration file. ### Bulk Publish All Assets The `**cm:bulk-publish:assets**` command lets you publish all assets of a particular stack on any environment(s). **Usage** ``` csdx cm:bulk-publish:assets -e --stack-api-key ``` **Options** - `-e`, `--environments=environments`: The name of the environment on which entries will be published. In case of multiple environments, specify their names separated by spaces. - `-a`, `--alias=alias`: Alias (name) of the management token. You must use either the `--alias` flag or the `--stack-api-key` flag. - `--stack-api-key=stack-api-key`: API key of the source stack. You must use either the `--stack-api-key` flag or the `--alias` flag. - `-B`, `--branch=branch`: The name of the branch where you want to perform the bulk publish operation. If you don’t mention the branch name, then by default the assets from **main** branch will be published. - `-b`, `--[no-]bulkPublish=bulkPublish`: Set this flag to use Contentstack’s Bulk Publish APIs. It is **true, **by default. - `-r`, `--retryFailed=retryFailed`: *(optional) * Use this option to retry publishing the failed assets from the logfile. Specify the name of the logfile that lists failed publish calls. If this option is used, it will override all other flags. - `-u`, `--folderUid=folderUid`: *(optional) * The UID of the Assets’ folder from which the assets need to be published. The default value is **cs_root**. - `-l`, `--locales=locales`: Locales in which assets will be published, e.g., *en-us*. In the case of multiple locales, specify the codes separated by spaces.** - `-y`, `--yes`: Set it to **true **to process the command with the current configuration. - `-c`, `--config=config`: *(optional) *The path of the optional configuration JSON file containing all the options for a single run. Refer to the [**configure**](#build-the-configuration-file) command to create a configuration file. ### Bulk Publish Entries/Assets from One Environment to Another The `**cm:bulk-publish:cross-publish**` command lets you publish all the entries and assets from one environment to a newly created or some other environment. **Usage** ``` csdx cm:bulk-publish:cross-publish -e -d -t -l --stack-api-key --onlyAssets ``` **Options** - `-e`, `--environment=environment`: The name of the source Environment. - `-d`, `--destEnv=destEnv`: The name of destination Environment. - `-t`, `--content-type=content-type`: The UID of the Content Type ID whose entries you want to publish in bulk. In case of multiple Content Types, specify their IDs separated by spaces. - `-l`, `--locale=locale`: Locale in which entries will be published, e.g., *en-us.* - `-b`, `--[no-]bulkPublish=bulkPublish`: Set this flag to use Contentstack’s Bulk Publish APIs. It is **true, **by default. - `-x`, `--deliveryToken=deliveryToken`: The delivery token of the source Environment. - `-a`, `--alias=alias`: Alias (name) of the management token. You must use either the `--alias` flag or the `--stack-api-key` flag to publish assets. Use the `--alias` flag to publish entries. - `--stack-api-key=stack-api-key`: API key of the source stack. You must use either the `--stack-api-key` flag or the `--alias` flag to publish assets. - `-B`, `--branch=branch`: Branch to fetch the content from (default = main). - `-r`, `--retryFailed=retryFailed` *(optional): * Use this option to retry publishing the failed entries from the logfile. Specify the name of the logfile that lists failed publish calls. If this option is used, it will override all other flags. - `-y`, `--yes`: Set it to **true **to process the command with the current configuration. - `-c`, `--config=config` *(optional): *The path of the optional configuration JSON file containing all the options for a single run. Refer to the [**configure**](#build-the-configuration-file) command to create a configuration file. - `--onlyAssets `*(optional)*: Use this flag to cross-publish only assets from the source environment. - `--onlyEntries `*(optional)*: Use this flag to cross-publish only entries (all the entries) from the source environment. ### Bulk Publish All Entries After Adding a New Field in the Content Type If you add a new field(s) to one or more content types, you have to update and publish the corresponding entries manually. To automate this process, the `**cm:bulk-publish:add-fields** `command lets you update and publish such entries in bulk. **Usage** ``` csdx cm:bulk-publish:add-fields -t -l -e ``` **Options** - `-t`, `--contentTypes=contentTypes`: The UID of the Content Type ID whose entries you want to publish in bulk. In case of multiple Content Types, specify their IDs separated by spaces. - `-l`, `--locales=locales`: Locales in which entries will be published, e.g., *en-us*. In the case of multiple locales, specify the codes separated by spaces. - `-e`, `--environments=environments`: The name of the environment on which entries will be published. In case of multiple environments, specify their names separated by spaces. - `-b`, `--[no-]bulkPublish=bulkPublish`: Set this flag to use Contentstack’s Bulk Publish APIs. It is **true, **by default. - `-a`, `--alias=alias`: Alias (name) of the management token. - `-B`, `--branch=branch`: The name of the branch where you want to perform the bulk publish operation. If you don’t mention the branch name, then by default the content from **main **branch will be published. - `-r`, `--retryFailed=retryFailed`: *(optional) * Use this option to retry publishing the failed entries from the logfile. Specify the name of the logfile that lists failed publish calls. If this option is used, it will override all other flags. - `-y`, `--yes`: Set it to **true **to process the command with the current configuration. - `-c`, `--config=config`: *(optional) * The path of the optional configuration JSON file containing all the options for a single run. Refer to the [**configure**](#build-the-configuration-file) command to create a configuration file. ### Bulk Publish Entries After Non-localized field is Updated The `**cm:bulk-publish:nonlocalized-field-changes**` command lets you publish the localized entries if the non-localized field of the master entry is updated. **Usage** ``` csdx cm:bulk-publish:nonlocalized-field-changes -t -s -e -a ``` **Options** - `-t`, `--contentTypes=contentTypes`: The UID of the Content Type whose entries you want to publish in bulk. In case of multiple Content Types, specify their IDs separated by spaces. - `-s`, `--sourceEnv=sourceEnv`: The name of the source environment. - `-e`, `--environments=environments`: The name of the environment on which entries will be published. In case of multiple environments, specify their names separated by spaces. - `-b`, `--[no-]bulkPublish=bulkPublish`: Set this flag to use Contentstack’s Bulk Publish APIs. It is **true, **by default. - `-a`, `--alias=alias`: Alias (name) of the management token. - `-B`, `--branch=branch`: The name of the branch where you want to perform the bulk publish operation. If you don’t mention the branch name, then by default the content from **main** branch will be published. - `-r`, `--retryFailed=retryFailed`: *(optional) * Use this option to retry publishing the failed entries from the logfile. Specify the name of the logfile that lists failed publish calls. If this option is used, it will override all other flags. - `-y`, `--yes`: Set it to **true **to process the command with the current configuration. - `-c`, `--config=config`: *(optional) * The path of the optional configuration JSON file containing all the options for a single run. Refer to the [**configure**](#build-the-configuration-file) command to create a configuration file. ### Restore/Unpublish Entries Published The `**cm:bulk-publish:revert**` command lets you unpublish the published entries and restore their version back to 1. **Usage** ``` csdx cm:bulk-publish:revert -l ``` **Options** - `-l`, `--logFile=logFile`: Path of the success logfile of a particular publish action. - `-r`, `--retryFailed=retryFailed`: *(optional) * Use this option to retry publishing the failed entries from the logfile. Specify the name of the logfile that lists failed publish calls. If this option is used, it will override all other flags. ### Bulk Unpublish Entries/Assets Unpublishing multiple entries/assets from several content types manually can be a time-consuming task. To ease this process, the `**cm:bulk-publish:unpublish**` command lets you unpublish all the entries/assets at once. **Note**: Use `--onlyAssets` option for unpublishing only assets and `--onlyEntries` for unpublishing only entries. If you do not specify either of these options, all the assets and entries will get unpublished at a time. **Usage** ``` csdx cm:bulk-publish:unpublish -e -l --stack-api-key --onlyAssets ``` **Options** - `-e`, `--environment=environment`: The name of the environment from where entries/assets need to be unpublished. - `-l`, `--locale=locale`: Locale from which entries/assets will be unpublished, e.g., *en-us.* - `-t`, `--contentType=contentType`: The UID of the content type whose entries you want to unpublish in bulk. - `--onlyAssets`: *(optional)* Use this option to unpublish only assets. - `--onlyEntries`: *(optional) *Use this option to unpublish only entries. - `-b`, `--[no-]bulkUnpublish=bulkUnpublish`: Set this flag to use Contentstack’s Bulk Publish APIs. It is **true, **by default. - `-x`, `--deliveryToken=deliveryToken`: The delivery token of the source environment. - `-a`, `--alias=alias`: Alias (name) of the management token. You must use either the `--alias` flag or the `--stack-api-key` flag to unpublish assets. Use the `--alias` flag to unpublish entries. - `--stack-api-key=stack-api-key`: API key of the source stack. You must use either the `--stack-api-key` flag or the `--alias` flag to unpublish assets. - `-B`, `--branch=branch`: The name of the branch where you want to perform the bulk unpublish operation. If you don’t mention the branch name, then by default the content from **main **branch will be unpublished. - `-r`, `--retryFailed=retryFailed`: *(optional) * Use this option to retry unpublishing the failed entries from the logfile. Specify the name of the logfile that lists failed unpublish calls. If this option is used, it will override all other flags. - `-y`, `--yes`: Set it to **true **to process the command with the current configuration. - `-c`, `--config=config`: *(optional) * Path of an optional configuration JSON file containing all the options for a single run. Refer to the [**configure**](#build-the-configuration-file) command to create a configuration file. ### Build the Configuration File The `**cm:bulk-publish:configure**` command lets you generate a template for the configuration JSON file. It will set the variables for the Bulk Publish commands. After you generate the configuration file, you can simply use its path in the `-c`, `--config=config` option of any Bulk Publish commands. You can view this [reference configuration file](https://github.com/contentstack/cli/blob/main/packages/contentstack-bulk-publish/src/config/index.js) for Bulk Publish commands. **Usage** ``` csdx cm:bulk-publish:configure ``` **Options** - `-a`, `--alias=alias`: Name (alias) of the management token you want to use **Additional Resources**: If you want to migrate your content from one stack to another, refer to the [Migration](/docs/developers/cli/migrate-content-using-cli) guide. ## Limitations - The [cm:bulk-publish:add-fields](#bulk-publish-all-entries-after-adding-a-new-field-in-the-content-type) command does not work for [custom](/docs/developers/create-content-types/custom) and [mandatory](/docs/developers/create-content-types/mandatory) fields. ## Common questions ### How do I avoid bulk publish failure? **Note**: To avoid bulk publish failure, we recommend you to bulk publish content of one content type at a time. ### How can I retry failed publish/unpublish calls? Use the `-r`, `--retryFailed=retryFailed` option and specify the name of the logfile that lists failed publish/unpublish calls. If this option is used, it will override all other flags. ### How do I run bulk publish commands using a configuration file? Use the `-c`, `--config=config` option and provide the path of the optional configuration JSON file containing all the options for a single run. ### How do I generate a configuration JSON template for bulk publish commands? Use the `**cm:bulk-publish:configure**` command: ``` csdx cm:bulk-publish:configure ```