Última modificação: 28 de agosto de 2025
O conteúdo global é o conteúdo que é compartilhado em diferentes partes de um site. Exemplos comuns são cabeçalhos, rodapés e barras laterais do site. Como desenvolvedor, você especificará quais componentes devem ser globais, usando parciais globais ou tornando os módulos globais. A HubSpot fornece uma experiência de edição diferente para os editores de conteúdo, o que facilita a edição do conteúdo global e a visualização das alterações nas páginas antes da publicação. Para saber mais sobre como editar o conteúdo global, consulte como usar o conteúdo global em vários modelos na Central de Conhecimento da HubSpot.
Editor de conteúdo global

​
Visão geral

O conteúdo global é melhor usado para mostrar as mesmas informações em várias páginas. Por exemplo, o cabeçalho e o rodapé do seu site, como o cabeçalho na parte superior desta página.
hubspot-developers-header
Abaixo estão alguns exemplos adicionais de áreas em que você pode usar conteúdo global:
  • Navegação secundária para diferentes seções do site
  • Rodapés com direitos autorais (ou sub-rodapés)
  • Barras laterais em posts de blog (para mostrar posts recentes, listagens de autores etc.)
Como o conteúdo global é usado em vários lugares em um site, é fundamental projetar e criar os parciais e módulos globais de forma a promover a acessibilidade.

​
Parciais globais vs. Módulos globais

Como desenvolvedor, você pode criar parciais globais e módulos globais, com algumas diferenças importantes entre eles:
  • Parciais globais são um tipo de modelo criado usando HTML e HubL que pode ser reutilizado em todo o site. Os tipos mais comuns de parciais são cabeçalhos de sites, barras laterais e rodapés.
  • Os Módulos globais são módulos compostos por um ou vários conteúdos que podem ser utilizados em diversas páginas no seu site. Alguns tipos comuns de módulos globais podem ser itens como formulários de assinatura de blogs, elementos secundários de navegação e calls to action.
Você deve evitar a inclusão de módulos globais em parciais globais, pois isso pode criar uma experiência de edição de conteúdo negativa.
Todos os módulos e campos dos parciais globais e módulos globais podem ser editados com facilidade no editor de conteúdo global.

​
Parciais globais

​
Criar uma parcial global

Uma parcial global é um tipo de modelo que você pode criar localmente por meio da CLI do HubSpot usando o comando create, conforme mostrado abaixo. 
hs create template <partial-file-name>
Quando solicitado a escolher um tipo de modelo, selecione global partial. Isso criará o seu modelo no diretório desejado com as anotações a seguir incluídas no arquivo HTML. 
<!--
  templateType: global_partial
  label: Page Header
-->
Para ver uma amostra de um parcial global de conteúdo, consulte a nossa boilerplate no GitHub.

​
Adicionar áreas de arrastar e soltar às parciais globais

Você pode habilitar os recursos de arrastar e soltar conteúdo dentro de seus parciais globais adicionando tags dnd_area, tal como faria nos modelos de página. Consulte a nossa documentação sobre a área de arrastar e soltar para obter mais informações.

​
Incluir uma parcial global no seu modelo existente

Para adicionar uma parcial global a um de seus modelos existentes, use a tag global_partial do HubL, fazendo referência ao caminho para sua parcial. Veja um exemplo do CMS Boilerplate usando essa tag. 
{% global_partial path="../partials/header.html" %}
Quando parciais globais são produzidas, elas são envolvidas por <div>. Isso é usado pelo editor de páginas para identificar que o conteúdo é uma parcial global. 
<div
  data-global-resource-path="cms-theme-boilerplate/templates/partials/header.html"
>
  <!-- Your header.html code is output here -->
</div>

​
Observação:

Não use global_partial dentro do <head> de um modelo. Fazer isso resultaria em um HTML inválido.Para a maioria das situações em que você gostaria de usar uma parcial global no cabeçalho, pode fazer mais sentido usar um módulo global com {%require_head%} para inserir código personalizado no cabeçalho e ainda fornecer campos de módulo.

​
Módulos globais

Você pode criar módulos globais como qualquer outro módulo usando a CLI, executando o comando hs create, como mostrado abaixo. 
hs create module <module_name>
Um módulo global é diferenciado pelo sinalizador global no arquivo meta.json do módulo. 
// meta.json file
{
  "css_assets": [],
  "external_js": [],
  "global": true,
  "help_text": "",
  "host_template_types": ["PAGE"],
  "js_assets": [],
  "other_assets": [],
  "smart_type": "NOT_SMART",
  "tags": [],
  "is_available_for_new_content": false
}
Você também pode criar módulos globais no HubSpot usando o Gerenciador de design. Saiba mais sobre como trabalhar com módulos nos seguintes recursos relacionados: