Skip to main content

Frequently Asked Questions

General​

Is HubSpot Deploy free?​

Yes, during the public beta period HubSpot Deploy is free to use. Pricing will be announced before the general availability release.

What HubSpot plan do I need?​

HubSpot Deploy works with any HubSpot plan that supports the metadata types you want to manage. Some metadata types (e.g. custom objects, workflows) require a HubSpot Professional or Enterprise plan. See Metadata Types for details.

Does HubSpot Deploy store my HubSpot data?​

HubSpot Deploy stores metadata snapshots in your own Git repository. We do not store your HubSpot data on our servers beyond what is needed to process a backup or comparison job. Metadata is fetched on demand and written directly to your repository.

Is HubSpot Deploy an official HubSpot product?​

No. HubSpot Deploy is an independent tool that uses the HubSpot public API. It is not affiliated with or endorsed by HubSpot, Inc.

Connections​

Can I connect more than one HubSpot portal?​

Yes. You can connect as many HubSpot portals as you need within a workspace. Each portal is connected independently via OAuth.

Can I use GitLab or Bitbucket instead of GitHub?​

Currently only GitHub is supported. GitLab and Bitbucket support are planned for a future release. Let us know if this is important to you.

What happens if I revoke HubSpot access?​

If you revoke HubSpot Deploy's access from your HubSpot account, the connection will show an error status. Backups and comparisons using that connection will fail until you reconnect. You should also delete the connection from HubSpot Deploy's Connections page.

Backups​

How long does a backup take?​

Backup duration depends on the size of your portal. Most portals complete in under 2 minutes. Large portals with many custom objects or workflows may take longer.

What branch should I use for backups?​

We recommend using a dedicated branch (e.g. hubspot-backups) rather than your main development branch. This keeps your backup history clean and separate from your code.

Can I trigger a backup manually?​

Manual backup triggers are not yet available. Backups run on the configured schedule. This feature is planned.

Comparisons & Deployments​

How long does a comparison take?​

Most comparisons complete in under 30 seconds. Large portals or repos with many metadata items may take longer.

Can I deploy only some of the changes in a comparison?​

Selective deployment (cherry-picking individual changes) is not yet supported. Deployments apply all changes shown in the comparison. This feature is planned.

Can I undo a deployment?​

There is no one-click undo. To revert a deployment, use your Git backup history to find the previous state and create a new deployment from that snapshot. See Rolling back a deployment.

Troubleshooting​

My backup is stuck in "pending"​

Background workers process backup jobs. If a job is stuck for more than 10 minutes, try pausing and re-enabling the backup. If the issue persists, contact support.

My comparison shows unexpected changes​

This can happen if your portal's metadata was modified outside of HubSpot Deploy (e.g. directly in HubSpot). The comparison reflects the actual current state of both sources.

I'm getting a HubSpot OAuth error​

Make sure you are authorizing with an account that has Super Admin access to the portal you're connecting. Some metadata types require super admin permissions to read.

Contact​

Can't find what you're looking for? Email us at [email protected]. We read every message.