HubSpot CLI commands

Last updated: May 9, 2024

Use this table to describe parameters / fields
Parameter	Description
`accountNameOrID`	Identify the new default account by its name (as set in the config file) or ID.

Use this table to describe parameters / fields
Parameter	Description
`accountNameOrID`	Identify the account to remove by its name (as set in the config file) or ID.


Argument	Description
`dest` Optional	Path to the remote developer file system directory you would like to list files for. If omitted, defaults to the account root.


Argument	Description
`src` Required	Path in HubSpot Design Tools
`dest` Optional	Path to the local directory you would like the files to be placed, relative to your current working directory. If omitted, this argument will default to your current working directory.


Options	Description
`--account`	Specify an `accountId` or name to fetch from Supports an alias of `--portal` for backward compatibility with older versions of the CLI.
`--overwrite`	Overwrite existing files with fetched files.
`--mode`	Specify if fetching a draft or published version of a file from HubSpot. Click here for more info


Argument	Description
`src` Required	Path to the local file, relative to your current working directory.
`dest` Required	Path in HubSpot Design Tools, can be a net new path.


Options	Description
`--account`	Specify a `accountId` or name to fetch from. Supports an alias of `--portal` for backward compatibility with older versions of the CLI.
`--mode`	Specify if uploaded files are published in HubSpot. See "modes" for more info.
`--clean`	An optional flag that will delete the destination directory and its contents before uploading.


Subcommands	Description
`filemanager`	Uploads the specified src directory to the File Manager, rather than to the developer file system in the Design Manager. Note: Uploaded files will be set to public, making them viewable by anyone with the URL. See our help documentation for more details on file visibility settings.


Argument	Description
`src` Required	Path to the local directory your files are in, relative to your current working directory
`dest` Required	Path in HubSpot Design Tools, can be a net new path.


Options	Description
`--account`	Specify a `accountId` or name to fetch from Supports an alias of `--portal` for backward compatibility with older versions of the CLI.
`--mode`	Specify if uploaded files are published or saved as drafts in HubSpot. Learn more about using modes.
`--initial-upload`	Causes an initial upload to occur before file saves have occured. Supports an alias of `-i`
`--remove`	Will cause watch to delete files in your HubSpot account that are not found locally.
`--notify=<path/to/file>`	log to specified file when a watch task is triggered and after workers have gone idle.


Argument	Description
`src` Required	Path to the remote developer file system directory your files are in.
`dest` Required	Path to move assets to within the developer file system.


Options	Description
`--account`	Specify a `accountId` or name to move files within. Supports an alias of `--portal` for backward compatibility with older versions of the CLI.


Argument	Description
`type` Required	Type of asset. Supported types include: `module` `template` `website-theme` `function` `webpack-serverless` `react-app` `vue-app`
`name` Required	The name of the new asset
`dest` Optional	The destination folder for the new asset, relative to your current working directory. If omitted, this will default to your current working directory.

Argument	Description
`path` Required	Path in HubSpot Design Tools


Options	Description
`--account`	Specify a `accountId` or name to remove a file from. Supports an alias of `--portal` for backward compatibility with older versions of the CLI.

By default there are some rules HubSpot automatically enforces. There is no way to override these defaults.

The following are always ignored:

hubspot.config.yml/hubspot.config.yaml
node_modules - dependencies
.* - hidden files/folders
*.log - NPM error log
*.swp - Swap file for Vim state
Icon\\r - Mac OS custom Finder icon
__MACOSX - Mac resource fork
~ Linux Backup file
Thumbs.db - Windows image file cache
ehthumbs.db - Windows folder config file
Desktop.ini - Windows custom folder attribute information
@eaDir - Windows Synology diskstation "hidden" folder where the server stores thumbnails.

Shell script

# ignore all files within a specific directory
/ignore/ignored
# ignore a specific file
/ignore/ignore.md
# ignore all .txt files
*.txt
# ignore all log files - useful if you commonly output serverless function logs as files.
*.log


Argument	Description
`src` Required	Path to the local file, relative to your current working directory. This command should be run in the theme's root directory..
`dest` Required	The path for the preview. This can be any value, and is only used internally and for display purposes on the preview page.


Argument	Description
`src` Required	The local JSON file to use to generate the HubDB table.


Options	Description
`--account`	Specify a `accountId` or name to create HubDB in. Supports an alias of `--portal` for backward compatibility with older versions of the CLI.


Argument	Description
`tableId` Required	HubDB table id found in the HubDB dashboard.
`dest`	The local path destination to store the `hubdb.json` file.

// store_locations.hubdb.json { "name": "store_locations", "useForPages": true, "label": "Store locations", "allowChildTables": false, "allowPublicApiAccess": true, "dynamicMetaTags": { "DESCRIPTION": 3, "FEATURED_IMAGE_URL": 7 }, "enableChildTablePages": false, "columns": [ { "name": "name", "label": "Name", "type": "TEXT" }, { "name": "physical_location", "label": "Physical Location", "type": "LOCATION" }, { "name": "street_address", "label": "Street address", "type": "TEXT" }, { "name": "city", "label": "City", "type": "TEXT" }, { "name": "state", "label": "State", "options": [ { "id": 1, "name": "Wisconsin", "type": "option", "order": null }, { "id": 2, "name": "Minnesota", "type": "option", "order": null }, { "id": 3, "name": "Maine", "type": "option", "order": null }, { "id": 4, "name": "New York", "type": "option", "order": null }, { "id": 5, "name": "Massachusetts ", "type": "option", "order": null }, { "id": 6, "name": "Mississippi", "type": "option", "order": null }, { "id": 7, "name": "Arkansas", "type": "option", "order": null }, { "id": 8, "name": "Texas", "type": "option", "order": null }, { "id": 9, "name": "Florida", "type": "option", "order": null }, { "id": 10, "name": "South Dakota", "type": "option", "order": null }, { "id": 11, "name": "North Dakota", "type": "option", "order": null }, { "id": 12, "name": "n/a", "type": "option", "order": null } ], "type": "SELECT", "optionCount": 12 }, { "name": "phone_number", "label": "Phone Number", "type": "TEXT" }, { "name": "photo", "label": "Store Photo", "type": "IMAGE" } ], "rows": [ { "path": "super_store", "name": "Super Store", "isSoftEditable": false, "values": { "name": "Super Store", "physical_location": { "lat": 43.01667, "long": -88.00608, "type": "location" }, "street_address": "1400 75th Greenfield Ave", "city": "West Allis", "state": { "id": 1, "name": "Wisconsin", "type": "option", "order": 0 }, "phone_number": "(123) 456-7890" } }, { "path": "store_123", "name": "Store #123", "isSoftEditable": false, "values": { "name": "Store #123", "physical_location": { "lat": 32.094803, "long": -166.85889, "type": "location" }, "street_address": "Pacific Ocean", "city": "at sea", "state": { "id": 12, "name": "n/a", "type": "option", "order": 11 }, "phone_number": "(123) 456-7891" } } ] }


Argument	Description
`tableId` Required	HubDB table id found in the HubDB dashboard.


Options	Description
`--account`	Specify a `accountId` or name to clear HubDB rows from. Supports an alias of `--portal` for backward compatibility with older versions of the CLI.


Argument	Description
`tableId` Required	HubDB table id found in the HubDB dashboard.


Options	Description
`--account`	Specify a `accountId` or name to delete HubDB from. Supports an alias of `--portal` for backward compatibility with older versions of the CLI.


Argument	Description
`--account`	The HubSpot account nickname from your hubspot.config. This parameter is required if you do not have a defaultAccount in your `hubspot.config`. Supports an alias of `--portal` for backward compatibility with older versions of the CLI.
`--json`	Output JSON into the command line with data on all of the functions. The JSON data includes, portal id, function id, route, raw asset path, method, secrets, created and last modified dates.


Argument	Description
`endpoint-name` Required	The endpoint name as defined in your serverless.json file (not the path to the function file).
`--file`	Output the logs to function.log
`--follow`	Tail the logs to get a live update as you are executing your serverless functions.
`--latest`	Output only the most recent log
`--account`	The HubSpot account nickname from your hubspot.config. This parameter is required if you do not have a defaultPortal in your hubspot.config. Supports an alias of `--portal` for backward compatibility with older versions of the CLI.
`--compact`	hides log output/info. Returns success/error and execution time.
`--limit=<number>`	limit the amount of logs displayed in output


Argument	Description
`secret-name` Required	Name of secret.
`secret-value` Required	The secret's value (auth detail, or otherwise).


Argument	Description
`secret-name` Required	The name of the secret, which you'll later use to reference the secret. This can be any unique value, though it's recommended to keep it simple for ease of use.


Argument	Description
`secret-name` Required	Name of secret you want to remove.


Argument	Description
`shortcut` Required	Provide the full shortcut name or alias of the short cut you wish to open in your browser.


Argument	Description
`--list` Required	Lists all of the shortcuts, their aliases and destinations.

Use this table to describe parameters / fields
Parameter	Description
`--theme-path` Required	Path to a theme in the Design Manager.
`--verbose`	When this parameter is excluded, the returned score is an average of all the theme's templates (default). When this parameter is included, the individual template scores are shown. You'll also receive Lighthouse report links for each template.
`--target`	This can either be desktop or mobile to see respective scores. By default, the target is desktop.

When creating a theme, use the following command to generate an editor-preview.json file which maps CSS selectors to theme fields. This enables content creators to see which theme elements will be impacted by updates to a field's styling options.

After running the command, you'll need to review and refine the editor-preview.json file to ensure that fields and selectors are mapped properly. While this command will make a rudimentary guess as to which fields affect which selectors, you'll need to make corrections based on how your theme is built. For example, this command cannot detect when modules are overriding styling or when you're using macros. Learn more about theme editor field highlighting.

The --mode option allows you to determine if local changes are published when uploaded to HubSpot. This option can be used in each command or set as a default in your hubspot.config.yml file.

The two options for --mode are --mode=draft and --mode=publish.

The following is the order of precedence for setting --mode:

Using --mode in a command will override all other settings.
Setting a defaultMode for each account in your hubspot.config.yml file, removes the need to use --mode in each command. It will override the top-level setting.
Setting a defaultMode at the top-level in your hubspot.config.yml file, sets a default--mode for all accounts. It will override the default behavior.
The default behavior for --mode is publish


Name	Description
`HUBSPOT_PORTAL_ID` Required	The HubSpot account ID.
`HUBSPOT_PERSONAL_ACCESS_KEY` Recommended	The personal access key of a user on the HubSpot account. All updates made will be associated to this user.
`HUBSPOT_CLIENT_ID`	The OAuth client ID.
`HUBSPOT_CLIENT_SECRET`	The OAuth secret.


Argument	Description
`src` Required	Root relative path to the theme folder in the design manager.


Argument	Description
`src` Required	Root relative path to the module folder in the design manager.

Share your feedback

Was this article helpful? Yes No

This form is used for documentation feedback only. Learn how to get help with HubSpot.

Developer References

Developer Community

App Ecosystem New

Template Marketplace

App Partner Program

CMS Reference Docs

HubSpot CLI commands

Show all commands

Install the CLI

Install to just the current directory

Update the CLI

Authentication

init

Authenticate an account

List authenticated accounts

Set default account

Remove an account

Remove invalid accounts

Interacting with the developer file system

List files

Fetch files

Upload files

Set a watch for automatic upload

Move files

Create new files

Remove files

Ignore files

Locally preview theme

HubDB Commands

Create HubDB table

Fetch HubDB Table

Clear rows in a HubDB table

Delete HubDB table

Serverless function commands

Create a function

List functions

Get logs

Add a secret

Update a secret

Remove a secret

List secrets

Open browser shortcuts

open

Command completion

Evaluate themes and templates for SEO and accessibility

Generate theme field selectors for in-app highlighting

Modes

Environment variables

Marketplace asset validation

Validate theme

Validate module

Share your feedback