HubSpot Developer Changelog

Introducing HubSpot CLI v8.0.0

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:

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.