Introducing HubSpot CLI v8.0.0

dennisedson — Mon, 26 Jan 2026 20:48:25 GMT

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

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 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

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
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.

Re: Introducing HubSpot CLI v8.0.0

Anton — Fri, 13 Feb 2026 09:20:42 GMT

Hey friend!

This update broke quite a lot today after I've updated yesterday.

Couldn't run

hs cms watch <local-path> <hs-path> --account=<some-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

Re: Introducing HubSpot CLI v8.0.0

dennisedson — Fri, 13 Feb 2026 14:57:17 GMT

Heyo @Anton ! long time no chat

Do you get an error? I am not able to reproduce

Re: Introducing HubSpot CLI v8.0.0

CDow — Wed, 18 Mar 2026 15:08:18 GMT

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 https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/commands/account-commands#hs-init-command.

Re: Introducing HubSpot CLI v8.0.0

dennisedson — Fri, 20 Mar 2026 15:45:05 GMT

@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.

topic Re: Introducing HubSpot CLI v8.0.0 in Developer Announcements

Introducing HubSpot CLI v8.0.0

What’s changing

Node.js requirements

Deprecated commands removed

Custom object schema command changes

Additional breaking changes

Bug fixes and improvements

CI/CD considerations

When is it happening?

Re: Introducing HubSpot CLI v8.0.0

Re: Introducing HubSpot CLI v8.0.0

Re: Introducing HubSpot CLI v8.0.0

Re: Introducing HubSpot CLI v8.0.0