What's New in Arc XP CLI
Discover the latest updates to Arc XP’s command line interface (CLI).
Arc XP CLI 1.4.0
Release dates
- Sandbox and Production - Wednesday, May 13, 2026
Release summary
The Arc XP CLI now supports migrating paid subscriptions into Arc XP Subscriptions.
- Use
simulateto validate your input file before migrating - Use
executeto create subscription records from a CSV - Use
terminateto remove subscriptions
For full details, input file format, and the recommended migration workflow, see Arc XP CLI: Subscriptions.
Users affected
Developers
Action required
Update to the latest Arc XP CLI version.
Arc XP CLI 1.3.1
Release dates
- Sandbox and Production - Wednesday, March 11, 2026
Release summary
We’ve introduced a new static-storage subcommand for use with Arc’s Static Storage API for Edge Rendering. This provides the ability to list, upload, and delete objects from static storage through the Arc XP CLI.
Bug fix
- Updated the README to include pagebuilder upload and deploy commands
- Corrected the description of the
ifx-download-bundlecommand using an incorrect translation string
Users affected
Developers
Action required
Update to the latest Arc XP CLI version. View the README for commands and their options.
Arc XP CLI 1.2.0
Release dates
- Sandbox and Production - Tuesday, September 9, 2025
Release summary
We’ve introduced new commands in the Arc XP CLI to streamline and simplify workflows for managing blocks and Fusion bundles, reducing manual steps and making deployments more efficient. These commands are designed to be easily incorporated into CI/CD pipelines, enabling automated build and deployment processes.
arcxp themes upload-bundle- Upload Fusion bundles directly to your configured environment. Useful for pushing bundles as part of an automated build step.arcxp themes upload-and-deploy-bundle- Upload Fusion bundles and immediately deploy them with a specified engine version. Ideal for continuous deployment pipelines, where tested bundles can be automatically promoted to staging or production environments.arcxp themes fork-block- Copy a block from the Themes repository into your local codebase — either as is or for customization.
Bug fix
Fixed a bug where the arcxp themes site-properties convert-properties command was not accounting for nested properties when converting JSON to .xlsx.
Improvement
Updated the arcxp themes site-properties convert-properties conversion so that site sheets are generated in alphabetical order when converting JSON to .xlsx.
Users affected
Developers
Action required
Update to the latest Arc XP CLI version. View the README for commands and their options.
Arc XP CLI 1.1.0
Release dates
- Sandbox and Production - Wednesday, July 23, 2025
Release summary
This release includes the following updates:
Arc XP CLI: Themes Settings Management
As part of the transition away from the legacy UI for managing site properties, the Arc XP CLI now provides a suite of tools to help teams manage theme-settings and blocks.json manually and effectively.
You can now view, export, and convert site properties from the command line:
-
arcxp themes site-properties printPrint all current site properties stored in Themes Settings directly in the terminal for quick reference. This would be used as a transition from the UI.
-
arcxp themes site-properties write-local-settings-fileSave the current site properties to a local file. This would be used as a transition from the UI.
-
arcxp themes site-properties convert-propertiesConvert between
.jsonand.xlsxformats:- Use
.xlsxto make edits in Excel (great for non-technical users) - Convert it back to
.jsonfor use in your project
- Use
These tools make it easier for developers and non-developers alike to manage site configurations in a structured, version-controlled workflow.
For examples and full command documentation, visit the Arc XP CLI documentation. And for more information, see Arc XP CLI: Themes Package.
Automated with CI/CD
To streamline your workflow and reduce risk during deployment, we recommend setting up CI/CD pipelines for your site configuration.
Our Do-It-Yourself CI/CD Deployment Script (for PageBuilder Engine Bundle) guide walks you through integrating CLI commands into your deployment process.
Arc XP CLI: PageBuilder Engine Logs
The Arc XP CLI has been enhanced to allow you to pull Engine logs directly for a specific request ID. Complete lightweight, self-service troubleshooting on your pages to accelerate your development process.
You can view the Engine logs through the command line:
arcxp pagebuilder view-logsand enter the<request id>when prompted.
To get started, visit Arc XP CLI: PageBuilder Engine Logs Package and npm: @arcxp/cli.
Users affected
Developers
Action required
To use this functionality, you must upgrade to Arc XP CLI 1.1.