The new HubSpot CLI and new blog template types

Community Manager

The new HubSpot CLI and new blog template types

The CMS CLI is now the HubSpot CLI. This will require manual effort to update to the new version. We're also adding 2 new template types for blogs.


What's happening?

CMS CLI is now the HubSpot CLI

The CLI began as a way to interact with the Developer File System, a core piece of the HubSpot CMS. The CLI however has grown to support features like the Files Tool's file system, HubDB, and special commands for working with and testing serverless functions. The CLI uses the HubSpot APIs under the hood. The CLI is growing into a really powerful tool, and does not need to be limited to being useful solely for working with the CMS. Names matter and this rebranding reflects the vision we have for the CLI.


Blog listing and blog post template types

You can now specify a template to be a blog listing, or blog post template specifically. This makes it easier to search and select the correct blog templates in blog settings.

The new template types are:

  • blog_listing - this is your listing of all of your blog's posts.
  • blog_post - this is the individual blog post detail template.

This is not a breaking change, existing templates with the blog templateType will still be supported, but it is recommended to use the more specific template types for new templates. Additionally in the future we will be able to provide new capabilities specific to these new template types.

The Design Manager has been updated to enable selecting these template types during template creation. 



The CLI hs create template command has been updated to have both the blog post and blog listing template options, making it easy to create these templates.

The HubSpot theme boilerplate was updated to also use the new template types. We recommend if you keep a fork of the boilerplate to make this same small change. 


When is this happening?

These changes have rolled out. 

Because the CLI package itself has been renamed you will need to take additional steps to properly upgrade to the new version. Please follow these instructions in order:

1. Remove the currently installed version of the CMS CLI.

In your terminal run:

npm uninstall -g @hubspot/cms-cli

2. Install the HubSpot CLI

In your terminal run:

npm install -g @hubspot/cli

You are now ready to get back to work.

The blog listing and post templates functionality is live and you can use it now. You can update any existing templates to use these new templateTypes. Take care to make sure you set the listing templates to stay blog_listing template, and blog post templates to blog_post to avoid issues in the settings screen.


If you have questions or concerns, let us know by leaving a comment!



Check out our Community Developer Blog
where we feature our Community driven developer podcast and how to content
2 Replies 2
Key Advisor | Diamond Partner


Thanks for sharing @dennisedson.


Is there a plan to enable drag&drop functionality to the blog_post template? We're hearing quite often "Can you make the blog post more flexible?" from our customers. Would be awesome give them this ability to create a more "unique" blog post. 




Did my post help answer your query? Help the Community by marking it as a solution

HubSpot Employee

Hey there @Anton, while we have nothing to announce regarding drag and drop in blog posts. We do hear you.

This blog_post and blog_listing change will make it easier for us to roll out new functionality updates that are specifically for those template types making blogs more flexible.

I recommend subscribing to the developer changelog to be made aware of developer changes as soon as they're released.

Jon McLaren

Sr. CMS Developer Advocate

If my reply answered your question, please mark it as a solution, to make it easier for others to find.