jQuery Settings in HubSpot

How to disable the HubSpot included jQuery library to avoid blank pages and errors

Back to Documentation

Do I need jQuery?

The theme contains the latest version of jQuery, so it is best to have this unchecked.

If your current site requires jQuery, select the latest version available.

My Page speed is impacted by jquery, what can I do?

As of v24, we have begun removing the dependency of the theme and modules on jQuery and are actively replacing jQuery with Vanilla JS.

The dependency will be fully resolved by v26, coming out in late August 2022.

Some of my modules do not work properly. What can I do?

Most likely the wrong version of jQuery is configured in your HubSpot settings.

My current website is using the preloaded jQuery, what do I do?

If your current website, landing pages, or blog are using templates or a theme that requires the jQuery to be preloaded via the HubSpot setting, we recommend updating it from 1.7x to 1.11x and then unchecking the box later when you are no longer using those templates and/or theme for your pages.

FYI - We are Removing the dependency of the theme on jQuery

We are currently in the process of removing the dependence on jQuery for POWER theme and will release updated instructions when the newest version becomes available.

This is currently planned for v26.

In this process, we will remove jQuery and will move to Vanilla JS, which will help improve page speed and page performance.

The theme contains a newer version of jQuery than what HubSpot includes by default. If you don't make these updates, elements on your page will not load due to the conflict between jQuery versions.

HubSpot included jQuery Library

HubSpot Settings → Website → Pages → jQuery

⚠️ Follow these steps only if you are running your current website, landing pages, and/or blog with a template or theme that requires jQuery via this setting to remain active. Otherwise, jump to New website instructions ↓

By default, 1.7x is selected
In the dropdown, change 1.7x to 1.11x

It is highly recommended to uncheck the jQuery setting to disable HubSpot included jQuery as soon as you no longer require it for any existing pages.

Follow these steps if you are new to CMS Hub or your existing website does not require jQuery, the theme already includes the latest version:

Uncheck the box to remove this jQuery instance entirely

jQuery Settings in HubSpot

jQuery VERSION

FAQ

Setup Instructions

HubSpot included jQuery Library

HubSpot Settings → Website → Pages → jQuery

Video Tutorial

Next Steps

NEVER MISS A POWER UPDATE