Skip to main content
Os modelos da HubSpot podem usar uma série de variáveis predefinidas que podem ser usadas para renderizar elementos úteis de sites e e-mails. Esta página é uma lista de referência dessas variáveis. Saiba mais sobre como criar suas próprias variáveis em um modelo ou módulo da HubL. Embora a maioria das variáveis listadas nesta página seja opcional, há algumas variáveis obrigatórias para criar e-mails e páginas a partir de seus modelos.
As variáveis listadas abaixo podem ser usadas individualmente colocando-as no delimitador }} conforme observado em nossa página Variáveis e Macros. Opcionalmente, você pode usar essas variáveis com outras partes do HubL templating language, como loops, filtros, funções, tags e muito mais.

Variáveis disponíveis em todos os modelos

As variáveis HubL abaixo podem ser usadas em modelos de e-mail, página ou blog. Para ver informações adicionais sobre a saída dessas variáveis, você pode usar o filtro de impressão, como mostrado abaixo.
| Variável | Tipo | Descrição | | --- | --- | --- | --- | | account | Dict | Um dicionário que armazena valores de propriedade da empresa de uma empresa associada primária de um contato conhecido. Você pode acessar propriedades específicas da empresa (personalizadas e padrões) por meio dessa variável adicionando um ponto seguido pelo nome da propriedade interna. Por exemplo, account.name imprimiria o nome da empresa principal associada ao contato.

Usar esta variável desabilitará o cache de páginas. Saiba mais sobre pré-renderização de páginas e alternativas de JavaScript. | | company_domain | String | Imprime o domínio da empresa definido em Site > Páginas > Marca > Link do logotipo. | | contact | Dict | Um dicionário que armazena valores de propriedade de contato para um contato conhecido. Você pode acessar propriedades de contato específicas (personalizadas e padrão) por meio dessa variável adicionando um ponto seguido pelo nome da propriedade interna. Por exemplo, contact.firstname imprimiria o primeiro nome do contato.

Usar esta variável desabilitará o cache de páginas. Saiba mais sobre pré-renderização de páginas e alternativas de JavaScript. | | content | Dict | Um dicionário que armazena várias propriedades pertencentes a um conteúdo específico, como um e-mail, uma página ou uma postagem. | | content.absolute_url | String | Imprime a URL completo de uma página, post ou versão de página web de um e-mail. | | content.archived | Booleano | Avalia para true se a página ou e-mail foi marcado como arquivado pelo usuário. | | content.author_email | String | O endereço de e-mail do criador do conteúdo. | | content.author_name | String | Nome e sobrenome do criador do conteúdo. | | content.author_username | String | O nome de usuário HubSpot do criador do conteúdo. | | content.campaign | String | O GUID da campanha de marketing à qual essa página ou e-mail está associado. Essa ID exclusiva pode ser encontrada na URL de uma campanha específica na ferramenta da Campanha. | | content.campaign_name | String | O nome da campanha de marketing à qual esta página, este post ou este e-mail está associado. | | content.created | Datetime | Um objeto datetime para quando o conteúdo foi criado originalmente, na hora UTC. Essa variável pode ser formatada com o filtro datetime. | | content.meta_description | String | Ao extrair a metadescrição de uma página, é melhor usar a variável page_meta.meta_description | . | | content.name | String | O nome de um post, e-mail ou página. Para páginas e e-mails, isso imprimirá o nome do conteúdo interno, enquanto para posts, isso imprimirá o título do post. Para posts de blog, esse é o título do post que é exibido. Para outros tipos de conteúdo, esse geralmente é um nome interno. Essa variável inclui um wrapper para que seja editável por meio da IU, quando incluída em postagens de blog. Se você quiser imprimir o nome do conteúdo sem um wrapper, use page_meta.name. | | content.publish_date | Datetime | Um objeto datetime que representa quando o conteúdo foi publicado, na hora UTC. Essa variável pode ser formatada com o format_datetimefiltro . | | content.publish_date_localized | String | Uma string que representa a data/hora em que o conteúdo foi publicado usando o fuso horário definido nas configurações padrão da conta. Esta variável também está sujeita às configurações de idioma e formato de data. | | content.template_path | String | O caminho do arquivo no Gerenciador de Design para o seu modelo (ou seja, custom/page/web_page_basic/my_template.html). | | content.slug | String | Imprime o URL completo de uma página, post ou versão de página web de um e-mail. Este é o valor que segue o domínio. Por exemplo, em https://example.com/about-us, o slug é about-us. Para o URL completo, use content.absolute_url em vez disso. | | content.updated | Data/hora | Um objeto datetime para quando o usuário atualizou o conteúdo pela última vez, na hora UTC. Essa variável pode ser formatada com o filtro datetime. Diferente de content.publish_date na publicação inicial. Use o |between_times filtro para testar se um post foi atualizado após a publicação. | | content_id | String | Imprime o ID exclusivo de uma página, post ou e-mail. Esse ID pode ser encontrado na URL do editor. Você pode usar esta variável como um alias para content.id. | | favicon_link | String | Imprime o URL de origem do favicon. Saiba mais sobre definições de favicons na HubSpot. | | hub_id | String | A ID da sua conta HubSpot. | | hubspot_analytics_tracking_code | String | Inclui o código de rastreamento de análise. Essa tag não é necessária, porque standard_footer_includes já renderiza o código de rastreamento. | | local_dt | Datetime | Um objeto datetime da hora atual no fuso horário definido em suas Configurações de Relatório. O uso dessa variável desativará o cache da página para retornar para a hora atual. Saiba mais sobre pré-renderização de páginas e alternativas de JavaScript. | | local_time_zone | String | O fuso horário, conforme configurado nas Configurações de Relatório da HubSpot. | | page_meta.canonical_url | String | A URL oficial em que esta página deve ser acessada. Normalmente não inclui nenhum parâmetro de string de consulta. Use isso para tag rel="canonical". A HubSpot canoniza automaticamente as URLs. | | page_meta.html_title | String | O título da página. Essa variável deve ser usada na tag <title> de modelos HTML. | | page_meta.meta_description | String | A metadescrição de uma página. Essa variável deve ser usada na tag “descrição” <meta> dos modelos HTML. | | page_meta.name | String | Um alias para content.name. | | portal_id | String | Um alias para a variável hub_id. | | request_contact | Dict | Um dicionário contendo dados sobre o contato solicitado. Não disponível nos modelos de e-mail. Usar esta variável desabilitará o cache de páginas. Saiba mais sobre pré-renderização de páginas e alternativas de JavaScript. | | site_settings | Dict | Um dicionário contendo várias configurações de página, blog e e-mail, incluindo cores e fontes e detalhes do rodapé do e-mail. | | year | String | Imprime o ano atual. |

Variáveis de e-mail

Veja a seguir as variáveis HubL que podem ser usadas em modelos de e-mail. Algumas variáveis, como as variáveis de configurações de cores e fontes, podem ser usadas em outros tipos de conteúdo se você quiser consultar as configurações de cor e fonte de seu e-mail em outro lugar.

Variáveis de modelos de e-mail necessárias

Para ser compatível com CAN-SPAM, todos os e-mails enviados pela HubSpot exigem determinadas informações da empresa e opt-out. Esta informação é definida pelas variáveis a seguir, que devem ser incluídas. Os valores desses tokens são extraídos das configurações de e-mail de marketing da conta. Existem variáveis de e-mail adicionais que são opcionais e estão listadas mais abaixo nesta página.

Configurações de cor e fonte

Existem vários controles básicos de cores e fontes nas configurações de e-mail marketing que podem ser impressos em e-mails. Onde indicado, você pode usar algumas dessas variáveis em modelos de página e blog adicionando site_settings. antes da variável.

Conteúdo do e-mail

Variáveis de e-mail para conteúdo privado

A lista de variáveis a seguir está disponível apenas dentro de modelos de e-mail usados para modelos de e-mail de conteúdo privado.

Variáveis de páginas do site

As seguintes variáveis estão disponíveis para páginas de site, landing pages, páginas de sistema e blogs.

Variáveis de modelo de página necessárias

Para publicar um arquivo codificado como uma página editável ou modelo de blog, as variáveis a seguir devem ser incluídas. Para publicar um arquivo HTML sem essas variáveis e usar em outro modelo, inclua isAvailableForNewContent: false na caixa anotações do modelo.

Variáveis de conteúdo e contato

Variáveis de solicitação HTTP

As variáveis a seguir imprimem informações sobre a solicitação de página HTTP. Algumas dessas variáveis impedirão o armazenamento em cache da página devido à necessidade de preencher dados dinamicamente no carregamento da página. Saiba mais sobre pré-renderização de páginas e alternativas de JavaScript.

Variáveis de blog

As seguintes variáveis estão disponíveis para modelos de blog. Algumas variáveis estão disponíveis apenas para listagens de posts, enquanto outras podem estar disponíveis apenas para posts de blog.

Páginas dinâmicas de objetos do CRM

As seguintes variáveis são usadas para construir páginas dinâmicas com objetos do CRM. Essas variáveis estão disponíveis apenas para páginas dinâmicas de objetos do CRM. | Variável | Tipo | Descrição | | --- | --- | --- | --- | | dynamic_page_crm_object | Dict | O objeto do CRM da página dinâmica que corresponde ao caminho da solicitação da página. Se a solicitação for para a página de listagem, esse valor será null | . | | dynamic_page_crm_object_type_fqn | String | O nome totalmente qualificado (FQN) do objeto do CRM. O FQN é uma ID exclusiva atribuída para o objeto, incluindo a ID da sua conta HubSpot e o nome do objeto. O FQN pode ser usado na crm_objects função. |

Variáveis do HubDB

As seguintes variáveis são utilizadas para criar páginas dinâmicas com o HubDB. Essas variáveis estão disponíveis apenas para páginas dinâmicas do HubDB. | Variável | Tipo | Descrição | | --- | --- | --- | --- | | dynamic_page_hubdb_table_id | Long | O ID da tabela selecionada na guia Configurações avançadas do editor de páginas. | | dynamic_page_hubdb_row | Dict | A linha do HubDB da página dinâmica que corresponde ao caminho da solicitação da página. Se a solicitação for para a página de listagem, esse valor será null | . | | row.hs_id | Longo | O ID interno de uma fileira HubDB. | | row.hs_name | String | O nome da fileira do HubDB. | | row.hs_path | String | O caminho da linha do HubDB. Usado para resolver uma solicitação para uma fileira na tabela especificada por dynamic_page_hubdb_table_id. | | row.hs_child_table_id | Longo | O ID da tabela-filha da fileira HubDB. Pode ser usado para criar modelos aninhados. | | row.hs_parent_row | Dict | A linha principal da linha do HubDB. Só pode ser usada ao usar tabelas filhas para modelos aninhados. | | dynamic_page_route_level | Inteiro | Profundidade atual de uma página em um modelo dinâmico multinível. O valor começa em 0 e aumenta com cada camada de tabela adicional. |

Variáveis de nós de menu

As variáveis a seguir estão disponíveis para uso no objeto retornado pela função de menu do HubL.

Editor no app e variáveis de visualização

Você pode usar as variáveis a seguir para verificar se o conteúdo está sendo renderizado no editor ou visualizador de conteúdo. Por exemplo, você pode querer usá-las para evitar a execução de código no editor enquanto ainda executa o código em páginas ativas.
Última modificação em 10 de fevereiro de 2026