Pular para o conteúdo principal
Esta página é um guia de referência abrangente da sintaxe e dos parâmetros disponíveis para todas as tags HubL padrão, incluindo tags para páginas do sistema, como a página de assinatura de e-mail. Cada tag abaixo contém uma amostra da sintaxe básica, além de um exemplo com parâmetros e saída de código. Se você estiver criando áreas de arrastar e soltar, saiba mais sobre as tags de área de arrastar e soltar. Caso mantenha um site mais antigo, você também pode verificar a lista de tags HubL descontinuadas.
A maioria das tags nesta página tem equivalentes de módulo padrão. Os módulos podem ser usados em dnd_areas e colunas flexíveis, tornando-os mais poderosos e fáceis de usar do que as tags que você vê aqui.

Comentários do blog

Renderiza o código de incorporação de comentários em um modelo de blog, incluindo os próprios comentários e o formulário de comentários. Saiba mais sobre como personalizar as configurações e formulários de comentários do blog em Base de conhecimento.

Conteúdo do blog

Embora os layouts de arrastar e soltar incluam um módulo de conteúdo do blog, esses módulos não são criados com uma única tag. Eles usam lógica condicional para definir como um post de blog e uma lista de blogs devem renderizar. Você pode aprender mais sobre codificação de modelos de blog aqui.

Filtro de post de blog

Cria uma listagem vinculada de postagens por tópico, posts por mês ou posts por autor.

Observação:

Este módulo só pode ser usado em modelos de posts de blog.

Listagem de posts de blog

Adiciona uma lista de posts mais populares ou de topo.

Observação:

Esta tag só pode ser usada em modelos de posts de blog. O conteúdo da tag é carregado de forma assíncrona no lado do cliente. Como resultado, se você quiser manipular o feed depois que ele for carregado, precisará definir uma função JS global para lidar com essa manipulação. Use a função hsPostListingComplete(feeds), onde feeds é o seletor jQuery em todos os feeds que foram concluídos. Você vai querer manipular diretamente o objeto DOM nessa função.

Posts de blog relacionados

Adiciona uma lista de posts de blog com base em um conjunto de parâmetros compartilhados por posts em blogs. Os posts são selecionados com base na relevância para os parâmetros definidos. Essa tag não gera um módulo editável em nível de página/pós; ela é totalmente configurada com HubL.
É altamente recomendado usar o parâmetro callback em vez de post_formatter para melhorar a velocidade de carregamento da página.

Exemplos

O exemplo a seguir gera uma lista de posts escritos por um dos três blog_authors especificados em dois blogs diferentes:
O exemplo a seguir gera uma lista de 10 posts relacionados a um post de blog específico, com a tag de blog “sales enablement”, e restritos a um intervalo de datas de publicação específico. Este exemplo especifica o parâmetro blog_post_ids, para que seja usado em uma página:
O exemplo a seguir gera uma listagem de cinco posts usando o parâmetro callback para controlar a saída de HTML da listagem de posts:

Compartilhamento social de blog

O compartilhamento social de blog renderiza contadores de compartilhamento em seus posts de blog (se ativado em Configurações de Conteúdo).

De assinatura do blog

Uma tag de assinatura de blog renderiza o formulário de assinante de blog para um blog específico. Este formulário é criado automaticamente sempre que um blog é criado em Configurações de conteúdo, e há sempre um formulário de assinatura por blog. Observe que os campos do formulário de inscrição são configurados na IU do editor de formulários.

Booleano

Uma tag booleana cria uma caixa de seleção na interface do usuário que imprime “verdadeiro” ou “falso”. Além de imprimir o valor, esse módulo é útil para definir a lógica de modelo condicional, quando combinado com o parâmetro export_to_template_context.

Escolha

Uma tag de escolha cria um menu suspenso na interface do usuário do editor de conteúdo que imprime o valor selecionado pelo usuário. As tags de escolha são ótimas para oferecer um conjunto predefinido de opções aos usuários, como imprimir o tipo de página como um cabeçalho de página. Além de imprimir o valor de escolha, essa tag é útil para definir a lógica de modelo condicional, quando combinada com o parâmetro export_to_template_context.

Cor

A tag de cor gera um seletor de cores na interface do usuário do editor de página que imprime um valor de cor HEXADECIMAL em um modelo. Observe que este módulo só pode ser usado em modelos, não em arquivos CSS. Se estiver usando essa tag em um <style> ou em linha, você deverá usar o parâmetro no_wrapper=True para remover o wrapper <span>.

CTA

Uma tag Call to Action ou CTA permite que os usuários adicionem um botão Call to Action do HubSpot a uma área predefinida de uma página.
*Embora esses parâmetros estejam incluídos aqui por serem abrangentes, o código gerado pelo HubSpot para preenchê-los é muito específico. Se você precisar de um CTA padrão selecionado, em vez de tentar desenvolver os parâmetros de CTA do zero, recomendamos configurar o CTA em um layout de modelo e, em seguida, clonar para o arquivo. Você pode copiar o módulo HubL CTA com todos os parâmetros definidos corretamente para você.Há também uma função CTA que gera um CTA a partir do ID.

HTML personalizado

Um módulo HTML personalizado permite que os usuários insiram o HTML bruto no editor de conteúdo. Se você precisar adicionar HTML padrão extensivo à tag, talvez queira usar a sintaxe de bloco.

Módulos personalizados

Os Módulos Personalizados permitem que os designers da HubSpot criem um grupo personalizado de objetos de conteúdo editáveis para serem usados em modelos e páginas no CMS da HubSpot, além de permitirque os profissionais de marketing controlem o conteúdo específico que aparece nesses módulos página por página. Você pode saber mais sobre módulos personalizados e sua sintaxe HubL simplificada aqui. Os módulos personalizados precisam ser criados no editor de Módulo Personalizado, mas podem ser incluídos em modelos codificados e módulos HubL. Você verá um ‘Snippet de utilização’ na barra lateral direita do editor do Módulo Personalizado em ‘Uso do Modelo’. Os módulos personalizados exigem que o ID do módulo seja uma cadeia de caracteres, bem como um parâmetro de caminho, a fim de especificar qual módulo carregar. O snippet de utilização também incluirá um parâmetro de rótulo. Veja a sintaxe abaixo:

Espaços reservados do editor

Para renderizar o conteúdo do espaço reservado para um módulo no editor, você pode adicionar conteúdo padrão aos campos do módulo ou usar a tag HubL editor_placeholder. Isso pode ser útil quando o módulo não tem ou não precisa de conteúdo padrão ou para simplificar a construção do módulo.
module-placeholder-content
Para adicionar um espaço reservado para editor a um módulo personalizado, primeiro adicione uma declaração se para o HTML do módulo para renderizar o espaço reservado quando não há conteúdo selecionado no editor. Por exemplo, o código a seguir pode ser usado para adicionar um espaço reservado para editor a um módulo CTA:
A primeira declaração if identifica se o módulo está presente. Então, a declaração elif identifica se o módulo está sendo renderizado no contexto do editor que usa a variável is_in_editor. Esta variável retorna true se o conteúdo está sendo renderizado em qualquer editor de conteúdo, mas você pode ser mais específico com outros editor e visualização no aplicativo variáveis.
Em seguida, defina o conteúdo do espaço reservado no arquivo do módulo meta.json.

Coluna flexível

Colunas flexíveis são colunas verticais em um modelo que permitem que os criadores de conteúdo insiram e removam módulos da página usando o editor de conteúdo. Ao codificar uma coluna flexível com HubL, você pode optar por envolver outros módulos HubL para fazê-los aparecer na coluna flexível por padrão. O código de exemplo abaixo mostra a sintaxe básica e uma coluna flexível de exemplo com um rich text e módulo de formulário contidos como conteúdo padrão. Observe que colunas flexíveis só podem ser adicionadas aos modelos de página, não aos modelos de blog ou e-mail. Os módulos não podem conter colunas flexíveis, mas podem conter campos e grupos repetíveis, que oferecem uma funcionalidade semelhante.

Observação:

Ao usar esta tag, o label precisa seguir o valor do name para que a coluna flexível funcione no editor de conteúdo. Por exemplo, a seguinte sintaxe é inválida:[% widget_container label="My label" "my_flexible_column" %}

Formulário

Permite que os usuários selecionem um formulário da HubSpot para adicionar à página. O código abaixo inclui um exemplo de uso da sintaxe de tag padrão HubL e um exemplo de uso de sintaxe de bloco.

Rodapé

Renderiza informações de direitos autorais com o ano e o nome da empresa especificados nas configurações de e-mail marketing da conta.

Galeria

Gera uma tag de galeria do HubSpot. Esta tag de galeria é baseada no Slick. Embora você possa criar um módulo de controle de galeria com a sintaxe de módulo padrão do HubL, se quiser predefinir slides padrão usando o HubL, use a sintaxe de bloco. Ambos os métodos são mostrados abaixo. As imagens da galeria são carregadas lentamente usando o JavaScript.

Cabeçalho

Gera um módulo de cabeçalho que renderizará o texto como uma tag h1-h6.

Ícone

Adiciona uma tag de ícone que permite que os usuários selecionem um ícone para uso. Os conjuntos de ícones suportados são FontAwesome 5.0,10, 5.14.0 e 6.4.2. Essa tag não pode ser usada nos módulos habilitados para e-mail.

Imagem

Cria uma tag de imagem que permite que os usuários selecionem uma imagem do editor de conteúdo. Se quiser que a imagem seja vinculada a um URL de destino, use a linked_image abaixo.

Src da imagem

Um módulo src de imagem cria um seletor de imagem no editor de conteúdo, mas em vez de imprimir uma tag img, ele renderiza a URL da imagem. Esta tag é geralmente usada com parâmetro no_wrapper=True, para que o src da imagem possa ser adicionado ao CSS integrado ou a outra marcação. Uma alternativa para usar essa tag é usar o parâmetro export_to_template_context.

Troca de idiomas

Adiciona um Ícone do Globo com links para as versões traduzidas de uma determinada página do CMS. Saiba mais sobre conteúdo em vários idiomas aqui.

Imagem vinculada

Cria uma imagem selecionável pelo usuário que está ligada a um link. Esta tag tem todos os parâmetros de um módulo de imagem com dois parâmetros adicionais que especificam o URL de destino do link e se o link abre em uma nova janela.

Logotipo

Uma marca de logotipo renderiza o logotipo da sua empresa a partir das configurações do kit de marca.
Gera um menu avançado com base em uma árvore de menus em Configurações de Conteúdo > Menus Avançados. Consulte menus e navegação para obter mais informações sobre como usar menus em modelos e módulos. Se id estiver definido como null, a tag de menu renderizará o menu padrão da conta da HubSpot.

Require_css

Uma tag HubL que coloca na fila um elemento de estilo a ser renderizado no <head>. Essa tag é semelhante à require_cssfunção , exceto que a tag insere estilo integrado em vez de uma folha de estilo. Essa tag também não é desduplicada em outras instâncias do CSS na mesma página. Ao construir um módulo, se você quiser inserir uma folha de estilo e usar o módulo várias vezes em uma única página, é melhor usar a função require_css.

Require_head

Uma tag HubL que enfileira qualquer coisa colocada dentro dela no standard_header_includes que está no <head> do modelo. Para a maioria dos Javascript e CSS, veja require_js e require_css. Alguns casos de uso para require_head incluem o fornecimento de meta tags e tags de link especiais (como prefetch e preconnect) a partir de módulos.

Require_js

Uma marca HubL que enfileira um elemento de script a ser renderizado. Para enfileirar um script para renderizar o <head /> de um arquivo diferente por meio de um elemento <script /> (em oposição a em linha, como mostrado aqui), use a função require_js(absolute_url)).

Rich text

Cria um editor de conteúdo WYSIWYG.

Lista de RSS

Carrega uma lista de conteúdo de um feed de RSS interno ou externo.

Observação:

Este módulo é carregado de forma assíncrona no lado do cliente. Como resultado, se você quiser manipular o feed depois que ele for carregado, precisará definir uma função JS global para lidar com essa manipulação. Use a função hsRssFeedComplete(feeds), onde feeds é o seletor jQuery em todos os feeds que foram concluídos. Você pode manipular diretamente o objeto DOM nessa função.

Cabeçalho da sessão

Gera um cabeçalho html e subcabeçalho <p>.
Os menus simples permitem criar menus de navegação básicos que podem ser modificados no nível da página. Ao contrário dos módulos de menu regulares, os menus simples não são gerenciados a partir da tela de Navegação nas Configurações do Site, mas sim do modelo e dos editores de página. Você pode usar a sintaxe do bloco para configurar uma árvore de menus padrão.

Compartilhamento social

As tags de compartilhamento social geram ícones de mídia social que podem ser usados para compartilhar uma página específica. Este módulo pode ser usado com sintaxe de bloco para personalizar as imagens de ícone e muito mais.

Espaçador

Uma tag espaçadora gera uma tag span vazia. Essa tag pode ser estilizada para agir como um espaçador. Nos layouts de arrastar e soltar, o módulo espaçador é envolvido em um recipiente com uma classe de span1-span12 para determinar quanto espaço o módulo deve ocupar na grade responsiva de doze colunas.

Tags de página do sistema

As tags a seguir podem ser usadas nas páginas do sistema, como as páginas de redefinição de senha ou assinatura de e-mail.

Cancelar assinatura de backup de e-mail

A tag de cancelamento de assinatura de backup é renderizada para os destinatários de e-mail se o HubSpot não puder determinar o endereço de e-mail quando o destinatário tentar cancelar a assinatura. Essa tag renderiza um formulário para o contato inserir um endereço de e-mail para cancelar a assinatura de comunicações de e-mail. Ela deve ser usada em um modelo de sistema de Cancelamento de Assinatura.

Assinaturas de e-mail

Esse módulo é renderizado quando um destinatário de e-mail vai editar suas preferências de assinatura. Ele deve ser usado em um modelo de sistema de preferência de assinatura.

Confirmação de assinaturas de e-mail

A confirmação de atualização de assinaturas de e-mail é um módulo que pode ser adicionado ao modelo de agradecimento para quando um destinatário atualizar suas preferências de assinatura ou cancelar a assinatura. Ele deve ser usado em um modelo de sistema de preferência de assinatura.

Login de membro

Cria um formulário de login para fornecer acesso ao conteúdo privado.

Registro de assinatura

Cria um formulário para se registrar para ter acesso ao conteúdo privado.

Solicitação de redefinição de senha

Cria um formulário para enviar um e-mail de redefinição de senha para acessar páginas protegidas com senha.

Redefinição de senha

Renderiza um formulário de redefinição de senha para acessar páginas protegidas por senha.

Solicitação de senha

Adiciona um prompt de senha às páginas protegidas por senha.

Texto

Cria uma única linha de texto. Essa tag pode ser útil para ser misturada à sua marcação, quando usada em conjunto com o parâmetro no_wrapper=True. Por exemplo, se você quiser que seus usuários finais possam definir um destino de uma âncora predefinida, poderá preencher o href com um módulo de texto com no_wrapper=True.

Textarea

Uma área de texto é semelhante a um módulo de texto, pois permite que os usuários insiram texto simples, mas oferece uma área maior para trabalhar no editor de conteúdo. Esse módulo não é compatível com HTML. Se quiser usar diretamente dentro de uma tag de empacotamento predefinida, adicione o parâmetro no_wrapper=true.

Reprodutor de vídeo

Renderize um player de vídeo para um arquivo de vídeo do gerenciador de arquivos que tenha a configuração Permitir integração, compartilhamento e rastreamento ativada.
Última modificação em 10 de fevereiro de 2026