Saltar al contenido principal
Esta página es una guía de referencia completa de la sintaxis y los parámetros disponibles para todas las etiquetas HubL, incluyendo las etiquetas para las páginas del sistema, como la página de suscripción de correo electrónico. Cada etiqueta que aparece a continuación contiene una muestra de la sintaxis básica, así como un ejemplo con parámetros y salida de código. Si estás creando áreas de arrastrar y soltar, descubre más información sobre las etiquetas de las áreas de arrastrar y soltar. Si mantienes un sitio web antiguo, también puedes consultar la lista de funciones de HubL obsoletas.
La mayoría de las etiquetas de esta página tienen equivalentes de módulos predeterminados. Los módulos se pueden utilizar dentro de las áreas de arrastrar y soltar dnd_areas y columnas flexibles, lo que los hace más potentes y fáciles de usar que las etiquetas que ves aquí.

Comentarios del blog

Renderiza el código de inserción de comentarios en una plantilla de blog, incluyendo los comentarios y el formulario para comentar. Obtén más información sobre cómo personalizar las configuraciones y formularios de los comentarios del blog en este artículo de la base de conocimientos.

Contenido del blog

Mientras que los diseños de arrastrar y soltar incluyen un módulo de contenido de blog, estos módulos no se crean con una sola etiqueta. Por el contrario, utilizan la lógica condicional para definir cómo debe presentarse una publicación y un listado de blog. Puedes obtener más información sobre la codificación de plantillas para blogs aquí.

Filtro de publicación de blog

Crea un listado enlazado de posts por tema, mensajes por mes o mensajes por autor.

Nota:

Este módulo solo se puede utilizar en las plantillas de publicaciones de blog.

Listado de publicaciones de blog

Agrega un listado de las publicaciones más populares o más importantes.

Nota:

Esta etiqueta solo se puede utilizar en las plantillas de publicaciones de blog. El contenido de la etiqueta se carga de forma asíncrona en el lado del cliente. Como resultado, si quieres modificar la sección de publicaciones después de que se haya cargado, tendrás que definir una función JS global para manejar esa manipulación. Utiliza la función hsPostListingComplete(feeds), donde feeds es el selector de jQuery de todas las secciones que se han completado. Se recomienda modificar directamente el objeto DOM en esa función.

Publicaciones relacionadas con el blog

Agrega un listado de publicaciones de blog basado en un conjunto de parámetros comunes a todas las entradas de todos los blogs. Las publicaciones se seleccionan según su nivel de relevancia con respecto a los parámetros establecidos. Ten en cuenta que esta etiqueta no genera un módulo editable para la página o la publicación y se configura completamente con HubL.
Recomendamos utilizar el parámetro callback en lugar de post_formatter para mejorar la velocidad de carga de la página.

Ejemplos

El siguiente ejemplo genera una lista de publicaciones escritas por uno de los tres blog_authors especificados en dos blogs diferentes:
En este ejemplo se genera una lista de 10 publicaciones relacionadas con una publicación de blog específica, con la etiqueta “habilitación de ventas” y restringida a un período de tiempo de fecha de publicación específico. En este ejemplo se especifica el parámetro blog_post_ids, por lo que se puede usar en una página:
En este ejemplo se genera una lista de cinco publicaciones utilizando el parámetro callback para controlar la salida HTML de la lista de publicaciones:

Compartir el blog en redes sociales

Compartir el blog en redes sociales muestra los contadores de contenido compartido de las publicaciones de blog (si están activos en la configuración del contenido).

Suscripción al blog

Una etiqueta de suscripción a un blog muestra el formulario de suscripción para un blog determinado. Este formulario se genera automáticamente cada vez que se crea un blog en la configuración de contenido, y cada blog cuenta con su propio formulario de suscripción. Ten en cuenta que los campos del formulario de suscripción se configuran en el editor de formularios de la interfaz de usuario.

Booleano

Una etiqueta booleana crea una casilla de verificación en la interfaz de usuario que imprime “verdadero” o “falso”. Además de imprimir el valor, este módulo es útil para definir la lógica condicional de la plantilla, cuando se combina con el parámetro export_to_template_context.

Elección

Una etiqueta de elección crea una lista desplegable en el editor de contenidos de la interfaz del usuario que imprime el valor seleccionado por el usuario. Las etiquetas de opción son ideales para dar a los usuarios un conjunto de ajustes preestablecidos, como la impresión del tipo de página como el encabezado de la página. Además de imprimir el valor de la opción, esta etiqueta es útil para definir la lógica condicional de la plantilla cuando se combina con el parámetro export_to_template_context.

Color

La etiqueta de color genera un selector de color en el editor de las páginas de la interfaz de usuario que imprime un valor de color HEX en una plantilla. Ten en cuenta que este módulo solo puede utilizarse en las plantillas, no en los archivos CSS. Si utilizas esta etiqueta en un <style> o en un CSS en línea, es recomendable usar el parámetro no_wrapper=True para eliminar el contenedor <span>.

CTA

Una etiqueta de llamada a la acción o CTA permite a los usuarios agregar un botón de llamada a la acción de HubSpot a un área predefinida de una página.
*Si bien estos parámetros se incluyen aquí para ofrecer una visión completa, el código que HubSpot genera para completarlos es muy específico. Si necesitas seleccionar una CTA predeterminada, en lugar de desarrollar los parámetros desde cero, se recomienda configurar la CTA en un diseño de plantilla y luego clonar al archivo. Así, podrás copiar el módulo HubL de la CTA con todos los parámetros correctamente definidos.También hay una función de CTA que permite generar una CTA a partir de su ID.

HTML personalizado

Un módulo de HTML personalizado permite a los usuarios introducir HTML sin formato en el editor de contenidos. Si necesitas agregar una gran cantidad de HTML predeterminado a la etiqueta, puedes utilizar la sintaxis de bloques.

Módulos personalizados

Los módulos personalizados permiten a los diseñadores crear un grupo personalizado de objetos de contenido editables que se utilizarán en las plantillas y páginas del CMS, al tiempo que permiten a los profesionales del marketing controlar el contenido específico que aparece en esos módulos página por página. Más información sobre los módulos personalizados y su sintaxis simplificada de HubL, aquí. Los módulos personalizados deben crearse en el editor de módulos personalizados, pero pueden incluirse en plantillas codificadas y módulos HubL. Verás un “fragmento de uso” en la barra lateral derecha del editor de módulos personalizados en “Uso de plantillas”. Los módulos personalizados requieren el ID del módulo como una cadena, así como un parámetro de ruta para especificar qué módulo cargar. El fragmento de uso también incluirá un parámetro de etiqueta. Consulta la sintaxis a continuación:

Marcadores de posición del editor

Para mostrar el contenido del marcador de posición de un módulo en el editor, puedes añadir el contenido predeterminado a los campos del módulo o utilizar la etiqueta de HubL editor_placeholder. Esta etiqueta puede ser útil cuando el módulo no tiene o necesita contenido predeterminado, o bien para optimizar la construcción del módulo.
module-placeholder-content
Para agregar un marcador de posición del editor a un módulo personalizado, añade primero una instrucción “if” al HTML del módulo para que muestre el marcador de posición cuando no haya contenido seleccionado en el editor. Por ejemplo, el siguiente código podría utilizarse para agregar un marcador de posición del editor a un módulo CTA:
La primera instrucción if identifica si el módulo está presente. Luego, la instrucción elif identifica si el módulo se renderiza en el contexto del editor utilizando la variable is_in_editor. Esta variable devuelve true si el contenido se está renderizando en cualquier editor de contenidos, pero puedes especificar aún más con las variables del editor y la vista previa .
Luego, define el contenido del marcador de posición en el archivo meta.json del módulo.

Columna flexible

Las columnas flexibles son columnas verticales en una plantilla que permiten a los creadores de contenido insertar y eliminar módulos en la página utilizando el editor de contenido. Al codificar una columna flexible con HubL, puedes elegir otros módulos de HubL para que aparezcan en la columna flexible por opción predeterminada. El código de ejemplo que aparece a continuación muestra la sintaxis básica y una columna flexible de ejemplo con un módulo de texto enriquecido y un formulario como contenido predeterminado. Ten en cuenta que las columnas flexibles solo pueden agregarse a las plantillas de página, pero no a las plantillas de blog o de correo electrónico. Los módulos no pueden contener columnas flexibles, pero pueden contener campos y grupos repetibles, lo que proporciona una funcionalidad similar.

Nota:

Cuando uses esta etiqueta, la label debe seguir el valor name de la columna flexible para funcionar en el editor de contenido. Por ejemplo, la siguiente sintaxis no es válida:[% widget_container label="My label" "my_flexible_column" %}

Formulario

Permite a los usuarios seleccionar un formulario de HubSpot para agregarlo a su página. El siguiente código incluye un ejemplo de uso de la sintaxis estándar de etiquetas HubL y un ejemplo de uso de la sintaxis de bloques.

Pie de página

Presenta la información de derechos de autor con el año y el nombre de la empresa especificados en la configuración de correos de marketing de la cuenta.

Galería

Genera una etiqueta de galería de HubSpot. Esta etiqueta de la galería está basada en Slick. Mientras que puedes crear un módulo de galería con la sintaxis estándar de HubL, si quieres predefinir diapositivas predeterminadas usando HubL, debes usar la sintaxis de bloques. A continuación se muestran ambos métodos. Las imágenes de la galería se cargan de forma diferida mediante JavaScript.

Encabezado

Genera un módulo de encabezado que mostrará el texto como una etiqueta h1 a h6.

Ícono

Agrega una etiqueta de ícono que permite a los usuarios seleccionar un ícono para usarlo. Los conjuntos de íconos compatibles son FontAwesome 5.0.10, 5.14.0 y 6.4.2. Esta etiqueta no puede utilizarse en los módulos habilitados para correo electrónico.

Imagen

Crea una etiqueta de imagen que permite a los usuarios seleccionar una imagen desde el editor de contenidos. Si quieres que la imagen se vincule a una URL de destino, debes usar linked_image debajo.

Src de la imagen

Un módulo src de la imagen crea un selector de imágenes en el editor de contenidos, pero en lugar de imprimir una etiqueta img, muestra la URL de la imagen. Esta etiqueta se usa generalmente con el parámetro no_wrapper=True, de modo que la imagen src se puede agregar al CSS en línea o a otros marcadores. Una alternativa al uso de esta etiqueta es utilizar el parámetro export_to_template_context.

Selector de idiomas

Agrega un ícono de globo con enlaces a las versiones traducidas de una determinada página del CMS. Más información sobre los contenidos multilingües aquí.

Imagen enlazada

Genera una imagen seleccionable por el usuario dentro de un enlace. Esta etiqueta tiene todos los parámetros de un módulo de imagen con dos parámetros adicionales que especifican la URL de destino del enlace y si el enlace se abre en una nueva ventana.

Logotipo

Una etiqueta de logotipo muestra el logotipo de tu empresa desde la configuración del kit de marca de la cuenta.

Menú

Genera un menú avanzado basado en un árbol de menús en Configuración de contenido > Menús avanzados. Consulta los menús y la navegación para obtener más información sobre el uso de los menús en las plantillas y los módulos. Si id se define como null, la etiqueta de menú mostrará el menú predeterminado de la cuenta de HubSpot.

Require_css

Una etiqueta HubL que pone en cola un elemento de estilo para ser representado en el <head>. Esta etiqueta es similar a la require_css función , excepto que esta etiqueta inserta el estilo en línea en lugar de hacerlo desde una hoja de estilo. Esta etiqueta tampoco se desduplica con otras instancias del CSS en la misma página. Si estás creando un módulo y quieres insertar una hoja de estilos, pero planeas usar ese módulo varias veces en una misma página, es posible que prefieras utilizar la función require_css.

Require_head

Una etiqueta HubL que pone en cola todo lo que se coloca dentro de ella en el standard_header_includes, que se encuentra en el <head> de la plantilla. Para la mayoría de Javascript y CSS, consulta require_js y require_css. Algunos casos de uso de require_head incluyen el suministro de metaetiquetas y etiquetas de enlace especiales (como prefetch y preconnect) de los módulos.

Require_js

Una etiqueta HubL que pone en cola un elemento de script para ser renderizado. Para poner en cola un script para renderizarlo en el <head />desde un archivo diferente a través de un elemento <script /> (en lugar de en línea como se muestra aquí), utiliza la función HubL require_js(absolute_url).

Texto enriquecido

Crea un editor de contenidos WYSIWYG.

Listado de RSS

Carga una lista de contenidos desde un canal RSS interno o externo.

Nota:

Este módulo se carga de forma asíncrona en el lado del cliente. Como resultado, si quieres modificar la sección de publicaciones después de que se haya cargado, tendrás que definir una función JS global para manejar esa manipulación. Utiliza la función hsRssFeedComplete(feeds), donde feeds es el selector de jQuery de todos los listados de publicaciones que se han completado. Puedes modificar directamente el objeto DOM en esa función.

Encabezado de la sección

Genera un título html y un subtítulo <p>.

Menú simple

Los menús simples permiten crear menús de navegación básicos que pueden modificarse a nivel de página. A diferencia de los módulos de menú normales, los menús simples no se gestionan desde la pantalla de navegación en la configuración del sitio web, sino desde los editores de plantillas y páginas. Puedes utilizar la sintaxis de bloques para configurar un árbol de menús predeterminado.

Compartir en redes sociales

Las etiquetas de contenido compartido en redes sociales generan íconos de redes sociales que pueden utilizarse para compartir una página determinada. Este módulo se puede utilizar con la sintaxis de bloques para personalizar las imágenes de los íconos y mucho más.

Separador

Una etiqueta espaciadora genera una etiqueta span vacía. Esta etiqueta se puede estilizar para actuar como espaciador. En los diseños de arrastrar y soltar, el módulo de espacio se encuentra dentro de un contenedor con una clase de span1 a span12, que determina cuánto espacio debe ocupar el módulo dentro de la cuadrícula responsiva de doce columnas.

Etiquetas de la página del sistema

Las siguientes etiquetas se pueden utilizar en las páginas del sistema, como las páginas de restablecimiento de contraseñas o de suscripción por correo electrónico.

Copia de seguridad de cancelaciones de suscripción por correo electrónico

La etiqueta de cancelación de suscripción con copia de seguridad se muestra a los destinatarios de correo electrónico si HubSpot no puede determinar su dirección de correo, cuando el destinatario intenta cancelar la suscripción. Esta etiqueta muestra un formulario para que el contacto ingrese su dirección de correo electrónico y cancele la suscripción de las comunicaciones por correo electrónico. Se debe utilizar en una plantilla del sistema de respaldo de cancelación de la suscripción.

Suscripciones a correos

Este módulo se muestra cuando un destinatario de correo electrónico va a editar sus preferencias de suscripción. Debe utilizarse en una plantilla del sistema de preferencias de suscripción.

Confirmación de suscripción a correos

La actualización de confirmación de suscripción al correo electrónico es un módulo que puede agregarse a la plantilla de agradecimiento para cuando un destinatario actualiza sus preferencias de suscripción o las cancela. Debe utilizarse en una plantilla del sistema de preferencias de suscripción.

Inicio de sesión de membresías

Crea un formulario de inicio de sesión para dar acceso a contenido privado.

Registro de membresías

Crea un formulario de registro para acceder a contenido privado.

Solicitud de restablecimiento de contraseña

Crea un formulario para enviar un correo electrónico de restablecimiento de contraseña para acceder a páginas protegidas por contraseña.

Restablecimiento de contraseña

Renderiza un formulario de restablecimiento de contraseña para acceder a páginas protegidas por contraseña.

Solicitud de la contraseña

Agrega un solicitud de contraseña a las páginas protegidas con contraseña.

Texto

Crea una sola línea de texto. Esta etiqueta puede ser útil para combinarse con el marcador cuando se utiliza junto con el parámetro no_wrapper=True. Por ejemplo, si quieres que los usuarios finales puedan definir el destino de un ancla predefinida, podrías rellenar el href con un módulo de texto con no_wrapper=True.

Textarea

Un textarea es similar a un módulo de texto ya que permite a los usuarios introducir texto sin formato, pero les da un área más grande para trabajar en el editor de contenidos. Este módulo no es compatible con HTML. Si quieres utilizarlo directamente dentro de una etiqueta de contenedor predefinida, agrega el parámetro no_wrapper=true.

Reproductor de video

Renderiza un reproductor de video para un archivo de video desde el administrador de archivos que tiene activa la opción Permitir incrustar, compartir y rastrear.
Última modificación el 10 de febrero de 2026