This release introduces breaking changes in HubSpot CLI v8.0.0, including a new minimum Node.js version of Node 20, removal of deprecated commands and legacy behaviors, and dropped support for older project versions.
This version will be effective on February 9, 2026.
What’s changing
HubSpot CLI v8.0.0 is a major release focused on maintenance and cleanup. It removes long-deprecated functionality and aligns the CLI with previously announced platform changes.
Node.js requirements
- The minimum supported Node.js version is now Node 20
- Legacy behavior for
hs theme previewon Node versions lower than 20 has been removed
This follows prior guidance:
- In April 2025, we announced an October target for deprecating Node 18 in all serverless functions and the CLI
Deprecated commands removed
Commands deprecated in favor of the newer hs cms, hs app, and updated command structure have now been fully removed. This follows the command reorganization announced in October 2025.
| Removed command | Replacement command |
|---|---|
| hs create | hs cms app|theme|module|webpack|function|template create |
| hs fetch | hs cms fetch |
| hs function deploy | hs cms function deploy |
| hs function list | hs cms function list |
| hs function server | hs cms function server |
| hs lint | hs cms lint |
| hs list | hs cms list |
| hs logs | hs cms function logs |
| hs module marketplace-validate | hs cms module marketplace-validate |
| hs mv | hs cms mv |
| hs remove | hs cms delete |
| hs theme generate-selectors | hs cms theme generate-selectors |
| hs theme marketplace-validate | hs cms theme marketplace-validate |
| hs theme preview | hs cms theme preview |
| hs upload | hs cms upload |
| hs watch | hs cms watch |
Custom object schema command changes
The following legacy commands have been removed in favor of updated equivalents:
| Removed command | Replacement command |
|---|---|
| hs custom-object schema create | hs custom-object create-schema |
| hs custom-object schema delete | hs custom-object delete-schema |
| hs custom-object schema fetch-all | hs custom-object fetch-all-schemas |
| hs custom-object schema fetch | hs custom-object fetch-schema |
| hs custom-object schema list | hs custom-object list-schemas |
| hs custom-object schema update | hs custom-object update-schema |
Additional breaking changes
- Removed support for 2023.2 projects
- Creating 2023.2 projects via
hs project createis no longer supported - Migrating legacy apps to 2023.2 using
hs app migrateis no longer supported
- Creating 2023.2 projects via
- Removed deprecated command:
hs project clone-app
- Removed support for the
HUBSPOT_PORTAL_IDenvironment variable- Use
HUBSPOT_ACCOUNT_IDinstead
- Use
Bug fixes and improvements
- Fixed an issue where CLI versions > 7.9.0 did not work with the
--use-envflag - General refactoring and cleanup tied to deprecated functionality removal
For full release details, see the GitHub release notes:
https://github.com/HubSpot/hubspot-cli/releases/tag/8.0.0
CI/CD considerations
This release does not force an immediate upgrade to HubSpot CLI v8.0.0. However, CI/CD pipelines may be affected once this version is adopted.
In particular, we recommend reviewing the following in automated environments:
- Environment variables
- Replace usage of the deprecated
HUBSPOT_PORTAL_IDenvironment variable withHUBSPOT_ACCOUNT_ID - This variable is commonly set in CI/CD workflows and is no longer supported in v8.0.0
- Replace usage of the deprecated
- GitHub Actions
- If you are using version 1 of the HubSpot CMS Deploy GitHub Action, upgrade to v1.8
- Earlier versions install the latest version of the HubSpot CLI, which may pick up breaking changes
- Version 1.8 pins installation to the latest v7 CLI release to avoid unexpected breaks
- CLI command usage
- Review pipeline scripts for deprecated or removed CLI commands
- Update command references to their supported replacements before adopting v8.0.0
When is it happening?
This change goes into effect on February 9, 2026.
Questions or comments? Join us in the developer forums.