- Arc XP Learning Center
- What's New in Arc XP
- What's new in Arc XP CLI
What's new in Arc XP CLI
Discover the latest updates to Arc XP's command line interface (CLI).
Release dates
Sandbox and Production - Wednesday, July 23, 2025
Release summary
This release includes the following updates:
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 print
Print 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-file
Save the current site properties to a local file. This would be used as a transition from the UI.
arcxp themes site-properties convert-properties
Convert between
.json
and.xlsx
formats:Use
.xlsx
to make edits in Excel (great for non-technical users)Convert it back to
.json
for use in your project
These tools make it easier for developers and non-developers alike to manage site configurations in a structured, version-controlled workflow.
Important
After you transition to the new workflow, using the UI again overwrites your manual changes to blocks.json
. Avoid using the legacy interface after transitioning to preserve your work.
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.
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-logs
and 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.