# Introducing HubSpot CLI v8.0.0 **URL:** \ **Category:** Developer Announcements\ **Tags:** announcement\ **Created:** [January 26, 2026, 8:43pm UTC](https://community.hubspot.com/t/introducing-hubspot-cli-v8-0-0/145380 "2026-01-26T20:43:31Z")\ **Posts on this page:** 5\ **Page:** 1
**Author:** ![dennisedson](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/dennisedson/32/28044_2.png) [@dennisedson](https://community.hubspot.com/u/dennisedson)\ **Post date:** [January 26, 2026, 8:43pm UTC](https://community.hubspot.com/t/introducing-hubspot-cli-v8-0-0/145380/1 "2026-01-26T20:43:31Z")
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 preview` on 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 ](https://community.hubspot.com/changelog/deprecation-of-node-v18-in-all-serverless-functions-and-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**](https://community.hubspot.com/changelog/october-2025-developer-rollup#:~:text=All%20CMS%E2%80%91related%20commands%20have). | **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 create` is no longer supported - Migrating legacy apps to 2023.2 using `hs app migrate `is no longer supported - Removed deprecated command: - `hs project clone-app` - Removed support for the `HUBSPOT_PORTAL_ID` environment variable - Use `HUBSPOT_ACCOUNT_ID` instead ### **Bug fixes and improvements** - Fixed an issue where CLI versions \> 7.9.0 did not work with the `--use-env` flag - 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](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_ID` environment variable with `HUBSPOT_ACCOUNT_ID` - This variable is commonly set in CI/CD workflows and is no longer supported in v8.0.0 - **GitHub Actions** - If you are using version 1 of the HubSpot CMS Deploy GitHub Action, [upgrade to **v1.8**](https://github.com/HubSpot/hubspot-cms-deploy-action/releases/tag/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. ---
**Author:** ![Anton](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/anton/32/103167_2.png) [@Anton](https://community.hubspot.com/u/Anton)\ **Post date:** [February 13, 2026, 9:20am UTC](https://community.hubspot.com/t/introducing-hubspot-cli-v8-0-0/145380/2 "2026-02-13T09:20:42Z")
Hey friend! This update broke quite a lot today after I’ve updated yesterday. Couldn’t run `hs cms watch --account=` nor `hs --version` nothing works with Node 20.19.2 Just fyi As of today, I’ve switched back to the 7.11.2 CLI version ---
**Author:** ![dennisedson](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/dennisedson/32/28044_2.png) [@dennisedson](https://community.hubspot.com/u/dennisedson)\ **Post date:** [February 13, 2026, 2:57pm UTC](https://community.hubspot.com/t/introducing-hubspot-cli-v8-0-0/145380/3 "2026-02-13T14:57:17Z")
Heyo @Anton ! long time no chat Do you get an error? I am not able to reproduce ---
**Author:** ![CDow](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/cdow/32/54892_2.png) [@CDow](https://community.hubspot.com/u/CDow)\ **Post date:** [March 18, 2026, 3:08pm UTC](https://community.hubspot.com/t/introducing-hubspot-cli-v8-0-0/145380/4 "2026-03-18T15:08:18Z")
I’m also seeing a lot of errors when trying to use the latest version of hubspot cli v8. With node version 20.1 almost all commands return a pathing error. ```code: ‘ERR_INVALID_ARG_TYPE’```. I also rolled back to an old version of the cli, which resolves the issues completely. Confirmed using the available commands @ the docs here [Account CLI commands - HubSpot docs](https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/commands/account-commands#hs-init-command). ---
**Author:** ![dennisedson](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/dennisedson/32/28044_2.png) [@dennisedson](https://community.hubspot.com/u/dennisedson)\ **Post date:** [March 20, 2026, 3:45pm UTC](https://community.hubspot.com/t/introducing-hubspot-cli-v8-0-0/145380/5 "2026-03-20T15:45:05Z")
@CDow , could you provide more detail in what commands you are using? Also, could you add the `--debug` flag to your hs cli command(s) that is resulting in this issue? Send it back to me and I will take a look.