Skip to main content
Adicione campos aos módulos e temas para permitir que os criadores de conteúdo controlem os diferentes aspectos de uma página dentro do editor de páginas. Saiba mais sobre todos os campos disponíveis para módulos e temas, além de suas propriedades disponíveis. Para obter mais informações sobre a implementação de campos de tema e módulo, incluindo grupos de campos e campos de repetição, consulte a visão geral dos campos de tema e módulo.

Propriedades utilizadas por todos os campos

Todos os campos compartilham um conjunto de propriedades comuns. Estes são campos gerais, como o nome do campo ou o texto de ajuda exibido para os criadores de conteúdo usando o campo no módulo ou tema.
| Parâmetro | Tipo | Descrição | Padrão | | --- | --- | --- | --- | --- | | name | String | O nome do campo, que você usará ao incorporar o campo e seus valores no módulo ou tema. Não pode conter espaços ou caracteres especiais. | richtext_field, date_field, etc. | | label | String | O texto que o criador do conteúdo vê com a descrição do campo. Pode conter espaços. | Rich text field, Date field, etc. | | required | Booleano | Determina se o campo pode ser deixado em branco no editor. Se true, o conteúdo não poderá ser publicado sem um valor no campo. | false | | locked | Booleano | Determina se o campo pode ser editado no editor de conteúdo. Se true, o campo não aparecerá no editor de conteúdo. | false | | type | String | O tipo de campo. Os tipos de campo são exclusivos por campo e podem ser encontrados na documentação de cada campo abaixo. | | | inline_help_text | String | O texto que exibe o rótulo do campo abaixo do campo (limite 400 caracteres). Melhor usado para informações necessárias para usar o campo. Você pode incluir as seguintes tags de HTML (outras tags serão ignoradas na renderização): a, b, br, em, i, p, small, strong, span. | | | help_text | String | O texto que é exibido no editor dentro de uma dica de ferramenta ao passar o cursor do mouse para ajudar o criador de conteúdo (limite de 300 caracteres). Melhor usado para informações complementares, mas não necessárias para usar o campo. Você pode incluir as seguintes tags de HTML (outras tags serão ignoradas na renderização): a, b, br, em, i, p, small, strong, span. | | | id | String | O ID exclusivo do campo, que é definido pelo HubSpot. Ao criar localmente, não é necessário especificar este ID. | | | visibility | Matriz | Define as condições de exibição do campo. Por exemplo, você pode definir um campo para exibir apenas quando outro campo de caixa de seleção tiver sido selecionado. Saiba mais sobre a visibilidade. | | | display_width | String | Por padrão, os campos são de largura completa no editor. Quando dois campos consecutivos no arquivo fields.json estiverem definidos como half_width, eles aparecerão um ao lado do outro no editor. | | | | alias_mapping | String | Um alias para o campo, que mapeia valores de campo existentes para um novo local sem quebrar o conteúdo existente. Isso pode ser útil quando for necessário atualizar um campo que está sendo usado no conteúdo ativo, como mover um campo da aba Conteúdo para a aba Estilos. Saiba mais sobre mapeamento de alias. | False |

Alinhamento

Imagem de fundo

Blog

Booleano

Um botão pode fazer sentido quando o valor do campo ativa/desativa outros campos que são mostrados de forma condicional. Outra situação em que um botão pode ser útil é quando o campo representa uma grande mudança de design para o módulo.As caixas de seleção fazem sentido para alterações menores que podem não ter um efeito tão significativo na exibição do módulo, como ocultar ou mostrar pequenos elementos individuais.

Borda

Escolha

Predefinições do botão de escolha

Para configurar um campo de escolha para exibir botões em vez de um menu suspenso, caixas de seleção ou botões de opção, você pode usar uma das predefinições abaixo. Cada predefinição permite um conjunto específico de rótulos de opções, que você precisará incluir na matriz choices. Esses rótulos não podem ser personalizados.
Predefinição de maiúsculas e minúsculas
| | expand_icon | caret | plus | chevron |
Ícone de expansão predefinido
| | icon_background_shape | none | square | rounded | circle |
Predefinição de forma de plano de fundo de ícone
| | icon_size | small | medium | large |
Predefinição de ícone
| | layout | cards | tiles | minimal |
Predefinição de layout
| | social_icon_background_shape | none | square | rounded | circle |
Predefinição de plano de fundo de ícone social
| | social_icon_size | small | medium | large |
Predefinição do tamanho do ícone social
|

Cor

CTA

Objeto do CRM

Propriedade do objeto do CRM

Além disso, você pode usar os seguintes snippets para retornar outros detalhes da propriedade:
  • {{ module.fieldname.property }}: retorna o nome interno da propriedade.
  • {{ module.fieldname.property_definition.label }}: retorna o rótulo da propriedade.
  • {{ module.fieldname.property_definition.type }}: retorna o tipo de propriedade (por exemplo, string).

Data

Data e hora

Endereço de e-mail

Incorporação

| Parâmetro | Tipo | Descrição | Padrão | | --- | --- | --- | --- | --- | | supported_source_types | Matriz | Tipos de fontes suportados para URLs oEmbed (oembed), código de incorporação HTML (html) ou Media Bridge (media_bridge). | ["oembed", "html"] | | supported_oembed_types | Matriz | O tipo de oEmbed suportado, inclui "photo", "video", "link" e "rich". Não se aplica a supported_source_types de html | [ "photo", "video", "link", "rich" ] | | supported_media_bridge_providers | Matriz | Matriz de IDs de provedor que determina quais provedores de Media Bridge estão disponíveis para selecionar conteúdo.Observação: esse parâmetro também será preenchido durante a instalação de um Aplicativo de provedor de Media Bridge. | | | | type | String | Este parâmetro está sempre definido como "embed" | "embed" | | default | Dict | Uma matriz contendo o parâmetro "source_type". Este parâmetro tem um valor baseado em string das opções fornecidas no parâmetro "supported_source_types". | oembed |

Arquivo

E-mail de acompanhamento

Fonte

Observação:

  • A família de fontes é determinada pela combinação das propriedades font e font_set. Você deve incluir ambas para carregar a fonte. Ao herdar campos, você precisa herdar ambos os valores.
  • Ocultar subcampos relacionados ao CSS com visibility não impedirá que o CSS seja exibido no estilo retornado pelo objeto de campo. Você ainda precisará incluir manualmente o CSS no objeto styles.

Formulário

Gradiente

Linha do HubDB

Tabela HubDb

Ícone

Imagem

Os campos de imagem são suportados nos módulos. As imagens podem ser usadas como campos de estilo. Você somente deve usar campos de imagem como campos de estilo se a imagem for puramente representativa, ou seja, não transmita significado e não seja uma imagem de fundo. Isso serve para seguir as práticas recomendadas de acessibilidade.

Logotipo

Número

Os parâmetros de sufixo e prefixo são para fins de exibição no editor de conteúdo e não afetam o valor numérico do campo.

Página

Rich text

Espaçamento

Ao usar o campo de espaçamento, observe o seguinte:
  • Você deve incluir uma lista units ao definir min ou max.
  • A propriedade units suporta os seguintes tipos de unidade: %, ch, em, ex, in, lh, pc, pt, px, Q, rem, vh, vmax, vmin e vw.
  • Quando um criador de conteúdo edita todos os deslocamentos de uma vez, o HubSpot usa o maior valor min e o menor valor max. Além disso, somente as unidades compartilhadas por todos os lados estarão disponíveis para o criador do conteúdo.

Tag

Texto

Alinhamento de texto

URL

Vídeo

Parâmetros de objeto conversion_asset

Última modificação em 10 de fevereiro de 2026