PHPackages                             jordanbeattie/craftcms-hubspot-forms - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. jordanbeattie/craftcms-hubspot-forms

ActiveCraft-plugin[Utility & Helpers](/categories/utility)

jordanbeattie/craftcms-hubspot-forms
====================================

Hubspot forms field for CraftCMS

5.1.0(1y ago)09803[3 issues](https://github.com/jordannbeattie/craftcms-hubspot-forms/issues)MITPHP

Since Aug 21Pushed 1y ago1 watchersCompare

[ Source](https://github.com/jordannbeattie/craftcms-hubspot-forms)[ Packagist](https://packagist.org/packages/jordanbeattie/craftcms-hubspot-forms)[ RSS](/packages/jordanbeattie-craftcms-hubspot-forms/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (9)Dependencies (3)Versions (15)Used By (0)

Hubspot Forms
=============

[](#hubspot-forms)

Select your HubSpot forms directly from a CMS field and render them with Twig. No more copy & pasting embed codes!

> **Disclaimer:** This plugin, "HubSpot Forms", is independently developed and is not officially endorsed by or affiliated with HubSpot, Inc. While it interacts with the HubSpot API, it is a third-party tool and any support or issues should be directed to the developers of this plugin, not HubSpot. The use of HubSpot's logo is for identification purposes only, signifying compatibility with HubSpot services.

Installation
------------

[](#installation)

### From the browser

[](#from-the-browser)

1. Download the plugin from the Craft Plugin Store
2. Install the plugin from the settings page
3. Enable the plugin from the settings page

### From the terminal

[](#from-the-terminal)

```
composer require jordanbeattie/craftcms-hubspot-forms

```

```
php craft plugin/install hubspot-forms

```

```
php craft plugin/enable hubspot-forms

```

Configuration
-------------

[](#configuration)

Create a HubSpot private app with the `forms` scope. Copy your access token and add it to the plugin settings `HubSpot Token` field.

> The HubSpot token field can accept `.env` variables. It is highly recommended that you keep your access token in your `.env` file.

CMS Field
---------

[](#cms-field)

The plugin adds a "HubSpot Form" field type where you can allow users to select a form present in your HubSpot account. See the templating section on how to render forms from the field.

Templating
----------

[](#templating)

Use the plugins `render()` function to output the form to the template. This requires you to pass the HubSpot form field (or form ID).

```
{{ craft.hubspotforms.render( myHubspotFormField ) }}

```

Example:

```
{{ craft.hubspotforms.render( entry.form ) }}

```

### Optional Attributes

[](#optional-attributes)

You can pass a JavaScript event via the `loadOnEvent` attribute to trigger the form to load when the JavaScript event is fired.

```
{{ craft.hubspotforms.render( myHubspotFormField, {
    loadOnEvent: 'myJavaScriptEvent'
}) }}

```

Example:

```
{{ craft.hubspotforms.render( entry.form, {
    loadOnEvent: 'DOMContentLoaded'
}) }}

```

Migrating from HubCraft
-----------------------

[](#migrating-from-hubcraft)

If you were previously using the jordanbeattie/craftcms-hubspot plugin, you can update your existing fields to the form field provided by this plugin with a simple command.

```
php craft hubspot-forms/migrate

```

This will ensure your plugin is installed and configured correctly and then list out each of the old fields before asking you to continue.

By continuing, each of the old fields will be updated to the HubspotFormDropdown provided with this plugin.

Once the command has been run, you should rebuild your project config with `php ./craft project-config/rebuild` to ensure all fields are synced correctly.

Once this is complete, you should update your templates to use the new syntax.

**Old syntax:**

```
{{ craft.hubspot.render( myFieldHandle ) }}

```

**New syntax:**

```
{{ craft.hubspotforms.render( myFieldHandle ) }}

```

Once your templates are updated, you can safely uninstall the HubCraft plugin.

Support
-------

[](#support)

[jordanbeattie.com](https://jordanbeattie.com)

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance32

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~35 days

Recently: every ~61 days

Total

11

Last Release

688d ago

Major Versions

1.0.1 → 4.0.02023-08-21

3.0.0 → 4.0.12023-10-05

3.0.2 → 4.0.22023-12-06

4.0.2 → 5.0.02024-08-04

4.1.0 → 5.1.02024-08-07

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6815944?v=4)[Jordan Beattie](/maintainers/jordannbeattie)[@jordannbeattie](https://github.com/jordannbeattie)

---

Top Contributors

[![jordannbeattie](https://avatars.githubusercontent.com/u/6815944?v=4)](https://github.com/jordannbeattie "jordannbeattie (7 commits)")

---

Tags

hubspotcmsFormsCraftcraftcmscraft-plugin

### Embed Badge

![Health badge](/badges/jordanbeattie-craftcms-hubspot-forms/health.svg)

```
[![Health](https://phpackages.com/badges/jordanbeattie-craftcms-hubspot-forms/health.svg)](https://phpackages.com/packages/jordanbeattie-craftcms-hubspot-forms)
```

###  Alternatives

[verbb/formie

The most user-friendly forms plugin for Craft.

100387.6k57](/packages/verbb-formie)[nystudio107/craft-seomatic

SEOmatic facilitates modern SEO best practices & implementation for Craft CMS 5. It is a turnkey SEO system that is comprehensive, powerful, and flexible.

1741.5M51](/packages/nystudio107-craft-seomatic)[verbb/navigation

Create navigation menus for your site.

92698.4k18](/packages/verbb-navigation)[verbb/workflow

Enforce multi-step review processes for creating entries.

138123.0k1](/packages/verbb-workflow)[verbb/comments

Add comments to your site.

13753.7k](/packages/verbb-comments)[verbb/vizy

A flexible visual editor field for Craft.

4249.7k](/packages/verbb-vizy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)