Defer dei moduli HubSpot: risolvi il render blocking senza modificare le pagine
Una soluzione drop-in per gli script dei moduli HubSpot che causano render blocking
Condividi
'Defer dei moduli HubSpot' in breve
I moduli HubSpot sono un ottimo modo per integrare i moduli direttamente nel tuo HubSpot CRM. In HubSpot puoi creare facilmente moduli e inserirli direttamente nel tuo sito web con un po' di codice JavaScript.
C'è solo un piccolo problema. Ad HubSpot non piacciono i Core Web Vitals e il modulo HubSpot rallenterà il tuo sito web.
I moduli HubSpot sono render blocking per impostazione predefinita. Lo script del modulo (v2.js) pesa circa 521 KB non compresso. È quasi l'intero payload JavaScript mediano di una pagina mobile secondo il Web Almanac 2025 (646 KB). Tutto questo, solo per un modulo.
Per sistemare PageSpeed sarà necessaria una riscrittura per ogni pagina in cui appare un modulo HubSpot. A volte questa non è un'opzione immediata. Ho creato un'alternativa drop-in per velocizzare i tuoi moduli senza dover modificare alcun codice a livello di pagina.

Codice del modulo HubSpot, il metodo lento
Il codice HubSpot predefinito per l'inserimento di moduli in un sito web sarà simile a questo:
<script
type="text/javascript"
src="//js.hsforms.net/forms/v2.js">
</script>
<script>
hbspt.forms.create({
portalId: '123456',
formId: '123456'
});
</script> Questo comporterà un avviso di Lighthouse 'Elimina le risorse di blocco della visualizzazione'. Il modulo HubSpot blocca il rendering della pagina per un intero secondo. Secondo il Web Almanac 2025, l'87% delle pagine fornisce ancora risorse render-blocking. L'incorporamento predefinito di HubSpot è uno dei peggiori trasgressori perché viene caricato in modo sincrono senza alcun attributo defer o async.

La tua prima idea potrebbe essere quella di applicare il defer allo script di HubSpot. Questo non funzionerà e restituirà un errore perché hbspt.forms.create() si aspetta che lo script di HubSpot sia già stato caricato. Risolviamo il problema!
Codice del modulo HubSpot, la soluzione rapida
A volte non c'è proprio il tempo di esaminare centinaia di pagine e riscrivere il codice per ogni modulo HubSpot. Ecco perché ho creato un'alternativa drop-in per moduli HubSpot più veloci e senza render-blocking:
L'idea è semplice. I moduli vengono richiamati chiamando hbspt.forms.create. Intercettiamo i moduli, attendiamo che il codice HubSpot si carichi in background e quindi eseguiamo lo script del modulo.
<script>
// cache hubspot forms here
var hubcache = {
forms: [],
letsgo: function() {
for (var i = 0; i < hubcache.forms.length; i++) {
// hubspot is now loaded, use the real hbspt
hbspt.forms.create(hubcache.forms[i]);
}
}
};
// override hbspt while hubspot is loading
var hbspt = {
forms: {
create: function(c) { hubcache.forms.push(c); }
}
};
</script>
<script
type="text/javascript"
defer
src="//js.hsforms.net/forms/v2.js"
onload="hubcache.letsgo()">
</script> Non dimenticare di riservare dello spazio per il modulo, poiché non blocca più il rendering e causerà un layout shift maggiore rispetto a se avessi precedentemente dimenticato di riservargli spazio. Imposta una min-height sul contenitore del modulo che corrisponda all'altezza del modulo renderizzato.
Alternativa: il pattern hsFormsOnReady
Il v2.js di HubSpot supporta anche una coda di callback non documentata chiamata hsFormsOnReady. Se controlli direttamente il codice da incorporare, questa è un'opzione più pulita:
<script defer src="//js.hsforms.net/forms/v2.js"></script>
<script>
(window.hsFormsOnReady = window.hsFormsOnReady || []).push(function() {
hbspt.forms.create({
portalId: '123456',
formId: '123456'
});
});
</script> L'hack drop-in mostrato sopra è l'approccio migliore quando non puoi modificare il codice di incorporamento esistente su ogni pagina. Il pattern hsFormsOnReady richiede la modifica individuale dello snippet di incorporamento di ogni modulo.
Codice del modulo HubSpot, il modo corretto
Non sono un grande fan dell'implementazione di hack come questo (sebbene mi piaccia scriverli). A volte sono necessari perché semplicemente non c'è abbastanza tempo a disposizione per riscrivere un sito web. Pertanto tieni sempre in considerazione PageSpeed prima di impegnarti con un'app/plugin esterna, ecc., che potrebbe causare ogni sorta di problemi. Se non sei sicuro delle implicazioni su PageSpeed, semplicemente chiedi a qualcuno come me. Noi lo sappiamo :-)
Il modo corretto è usare direttamente le API dei moduli HubSpot. Costruisci il tuo modulo HTML, modificalo come preferisci e invia i dati ad HubSpot con una semplice richiesta POST:
fetch(
'https://api.hsforms.com/submissions/v3/integration/submit/PORTAL_ID/FORM_ID',
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
fields: [
{ name: 'email', value: email },
{ name: 'firstname', value: firstName }
]
})
}
); Zero JavaScript da HubSpot. Zero render blocking. Integrazione completa del CRM. Il modulo appare ancora nella tua dashboard HubSpot, attiva flussi di lavoro e alimenta il tuo database di contatti. Semplicemente non hai bisogno di 521 KB di codice HubSpot per inviare alcuni campi.
Per confermare che la tua correzione funzioni effettivamente per i visitatori reali, imposta il Real User Monitoring. I punteggi di laboratorio ti dicono che il modulo non è più bloccante, ma i dati sul campo ti dicono se i tuoi INP e LCP sono effettivamente migliorati.

Ti serve un sito più veloce?
Sono Arjen e da 17 anni sistemo siti lenti. Se hai problemi che non riesci a risolvere da solo, mandami il tuo URL e ne parliamo.
Mandami il tuo URL
Perché il fix non funziona?
A volte la CDN serve ancora il vecchio HTML, oppure il fix è finito nel template desktop e il mobile ne usa un altro. Mandami il tuo URL e il problema, e ti rispondo con qualche orario. Prima analizzo i tuoi field data, poi dedichiamo un'ora al tuo sito, ed entro un giorno hai le mie note per iscritto. 350 € IVA esclusa.
Mandami il tuo URLNon hai uno sviluppatore per il fix? Faccio io il lavoro, su una copia del tuo sito.