Última modificación: 12 de septiembre de 2025
‘Descubre cómo HubSpot preprocesa el contenido para mejorar la velocidad de carga de la página y la seguridad.’; Para mejorar la velocidad de carga de las páginas y la seguridad, HubSpot crea automáticamente versiones estáticas de las páginas, publicaciones de blog y artículos de la base de conocimientos cuando sea posible. En otras palabras, en lugar de ensamblar los datos y el diseño de la página en el momento de cargarla, HubSpot renderizará la página con antelación para que esté lista al momento de ser usada. Las copias de estas páginas precreadas se almacenan en la CDN de HubSpot en todo el mundo para que los visitantes puedan acceder más rápidamente a las páginas según su ubicación. Sin embargo, no todas las páginas son aptas para el prerenderizado. Cuando una página contiene determinadas funciones o variables HubL, o utilice determinadas características de la página, impedirá que se prerrenderice. Del mismo modo, en algunos casos, una página puede prerrenderizarse parcialmente, lo que proporciona muchas de las mismas ventajas de rendimiento y seguridad que el prerrenderizado completo. A continuación, encontrarás más información sobre el proceso, cómo solucionar problemas y qué características afectarán la prerrenderización.

​
Proceso de prerrenderización

El proceso de prerrenderización se desencadena automáticamente al realizar las siguientes acciones:
  • Publicar una edición en la plantilla de una página.
  • Actualizar datos compartidos, como algunos ajustes del sitio web.
  • Actualizar un módulo incluido en una plantilla o página.
Durante el proceso de prerrenderización, HubSpot crea una versión estática de la página para que esté lista para ser servida cuando se solicite su URL. Esto mejora la velocidad de carga de la página, ya que hay menos procesamiento del lado del servidor durante cada solicitud. En términos de seguridad, las páginas estáticas reducen la exposición a posibles vulnerabilidades asociadas al código dinámico y a las consultas a la base de datos. Generalmente, el proceso de prerrenderización tarda segundos en completarse. Los cambios más extensos, como la actualización de un módulo incluido en muchas plantillas y páginas, pueden tardar varios minutos en completar el renderizado de la página. Los archivos CSS, JavaScript e imágenes siempre se generan de forma estática en HubSpot, por lo que siempre están prerrenderizados.

​
Comprobar si una página está prerrenderizada

Hay dos formas de comprobar si una página está prerrenderizada:
  • ?hsDebugOnly=true: carga la página con un parámetro de consulta ?hsDebugOnly=true. Esto incluirá un indicador de si la página se puede prerrenderizar. Si no se puede prerrenderizar, aparecerá una lista de los problemas que impiden la prerrenderización, junto con los archivos específicos y los números de línea de la plantilla. Si el formato de la información de depuración es difícil de leer, puedes utilizar en su lugar el parámetro ?hsDebug=true. Cuando inspecciones la página con ese parámetro de consulta, aparecerá la misma información de depuración en un comentario con formato HTML cerca de la parte inferior de tu página.
Screenshot of HTML comment showing that page can be prerendered
  • X-HS-Prerendered: busca el encabezado X-HS-Prerendered en los encabezados de respuesta HTTP de la solicitud de la página. Este encabezado solo estará presente si la página está prerrenderizada, e incluirá el valor de la última vez que se prerrenderizó. Puedes encontrar esta información inspeccionando la página, haciendo clic en la pestaña de red y mirando los encabezados de respuesta de la solicitud de la página.
chrome network tab showing prerendered header

​
Funciones incompatibles

Las siguientes variables HubL, funciones HubL y características de contenido evitarán que una página sea prerenderizada. Estas características impiden que se sirva la misma respuesta a todos los usuarios, por lo que evitan que se sirva una página estática prerrenderizada. Las páginas que utilicen algunas de estas funciones pueden servirse utilizando un prerrenderizado parcial.

​
Variables HubL incompatibles

  • account
  • company
  • contact
  • local_dt
  • owner
  • request_contact
  • request.cookies
  • request.full_url
  • request.headers
  • request.path_and_query
  • request.query
  • request.query_dict
  • request.referrer
  • request.remote_ip
Ten en cuenta que, aunque las variables de request no son compatibles con el prerenderizado, generalmente tienen alternativas en JavaScript que puedes utilizar para acceder a información similar.

​
Funciones HubL incompatibles

  • personalization_token()
  • today()

​
Funcionalidades incompatibles

​
Prerrenderizado parcial

El prerrenderizado parcial permite a HubSpot servir páginas parcialmente prerrenderizadas. Por ejemplo, una página puede ser totalmente estática excepto por el nombre de un contacto que aparece en ella. La página puede estar prerrenderizada excepto ese nombre de contacto. Justo antes de devolver la página al usuario, HubSpot realizará un renderizado solo de esos valores dinámicos. Las páginas que utilizan el prerrenderizado parcial no pueden almacenarse en caché en la CDN ni en el navegador. Sin embargo, las páginas parcialmente prerrenderizadas son más rápidas de entregar que las páginas que no pueden prerrenderizarse parcialmente. Las páginas parcialmente prerrenderizadas también tienen la capacidad de volver a un estado no personalizado en caso de interrupción o ataque. Aunque el prerrenderizado parcial puede ayudar a la velocidad y fiabilidad de tu sitio, eliminar las características de HubL que hacen que las páginas no sean prerrenderizables tendrá un efecto positivo mucho mayor en el rendimiento general de tu página.

​
Comprueba el prerrenderizado parcial

Para comprobar si una página puede ser parcialmente prerrenderizada, carga la página con un parámetro de consulta ?hsPrcDebug=true, y habrá una salida adicional sobre el contenido prerrenderizado de esa página. Si la página está prerrenderizada, el encabezado X-HS-Prerendered estará presente y contendrá partial antes del momento en que la página fue parcialmente prerrenderizada. A continuación se muestra una lista de variables y filtros HubL que actualmente son compatibles con la prerrenderización parcial. Las páginas que incluyan estas variables y filtros se prerrenderizarán parcialmente, y las expresiones que las incluyan se evaluarán en el momento de servir.

​
Variables de HubL

  • account
  • company
  • contact
  • local_dt
  • owner
  • query
  • request
  • request_contact
  • year

​
Filtros de HubL

  • |random
  • |shuffle

​
Alternativas en JavaScript a HubL incompatible

Aunque las distintas request de variables HubL no son compatibles con la prerrenderización, estas variables suelen tener alternativas en JavaScript que puedes utilizar para acceder a información similar. Por ejemplo, en lugar de la variable request.cookies, podrías utilizar la propiedad cookie. A continuación se muestra un ejemplo de uso de HubL frente a JavaScript para mostrar dinámicamente el contenido según si el usuario ha visitado antes el sitio (basándose en sus cookies). 
{% set hubspot_utk = request.cookies.hubspotutk %} {% if hubspot_utk %}
<div class="returning-visitor">
  <h2>Welcome back!</h2>
  <p>Thanks for returning. Here's what's new since your last visit:</p>
  <ul class="updates-list">
    <li>New product features launched</li>
    <li>Updated pricing plans</li>
  </ul>
</div>
{% else %}
<div class="new-visitor">
  <h2>Welcome to our site!</h2>
  <p>New here? Check out our Get Started guide:</p>
  <a href="" class="btn btn-primary">Get Started</a>
</div>
{% endif %}

​
Recursos relacionados