Guia técnico para o desenvolvedor do site: trocar o embed que carrega o formulário junto com a página por um acionamento no clique do CTA, com os identificadores de cada unidade.
Desenvolvedor responsável pelos projetos Webflow das unidades.
O embed padrão do Fillout é colado dentro de uma div e faz duas coisas indesejadas nas páginas atuais: desenha um botão flutuante próprio, fora do padrão visual do site, e monta o iframe do formulário já no carregamento da página, somando megabytes de JavaScript antes de qualquer interação. O próprio script oferece um caminho melhor: quando os atributos são aplicados a um elemento que não é uma div, ele deixa de criar o botão flutuante e passa a anexar a abertura do formulário ao clique daquele elemento. Na prática, é possível usar os botões que já existem no Webflow e carregar o formulário somente quando a pessoa decide se inscrever.
O script embed/v1 do Fillout percorre os elementos que possuem o atributo data-fillout-id. Se o elemento é uma div, ele trata aquilo como container e monta o formulário ali, além de criar o botão flutuante quando o tipo é slider ou popup. Se o elemento não é uma div, ele apenas registra o disparo no clique. Essa diferença é o que permite usar o botão nativo do Webflow como gatilho.
Localize o bloco Embed que contém a div com data-fillout-id e o script. Ele será substituído pelo script único no rodapé mais os atributos no botão.
Project settings, aba Custom code, campo Footer code. Cole apenas a tag script. Se o site tiver páginas com código próprio, confirme que o script não está repetido.
Pode ser um Button ou um Link Block já existentes. O importante é que o elemento não seja uma div. Não use Div Block nem Section como gatilho.
Com o elemento selecionado, abra Element settings e vá em Custom attributes. Adicione um par nome e valor para cada atributo da tabela da unidade correspondente.
No campo de link do Button ou Link Block, use a URL # para evitar navegação. Se o botão apontar para outra página, o clique leva embora antes de o formulário abrir.
Custom code do projeto não roda no preview do Designer. O teste precisa acontecer no site publicado, incluindo o subdomínio webflow.io quando usado como homologação.
<script src="https://server.fillout.com/embed/v1/"></script>Project settings > Custom code > Footer code. Uma vez por projeto.
| Nome do atributo | Valor | Função |
|---|---|---|
| data-fillout-embed-type | slider | Abre o formulário em painel lateral, sobre a página. |
| data-fillout-slider-direction | right | Define o lado de entrada do painel. |
| data-fillout-domain | forms.novosconceitos.com.br | Usa o domínio próprio do formulário, e não o domínio padrão do Fillout. |
| data-fillout-popup-size | medium | Largura do painel. |
| data-fillout-inherit-parameters | true | Repassa ao formulário os parâmetros presentes na URL da página, como as UTMs. |
<div data-fillout-id="7z8nKUGg5Jus" data-fillout-embed-type="slider" data-fillout-button-text="Pré-inscrição 2027" data-fillout-button-color="#F04E25" data-fillout-button-size="medium" data-fillout-button-float="bottom-left" data-fillout-slider-direction="right" data-fillout-inherit-parameters data-fillout-domain="forms.novosconceitos.com.br" data-fillout-popup-size="medium"></div>
<script src="https://server.fillout.com/embed/v1/"></script>| Nome | Valor |
|---|---|
| data-fillout-id | 7z8nKUGg5Jus |
| data-fillout-embed-type | slider |
| data-fillout-slider-direction | right |
| data-fillout-domain | forms.novosconceitos.com.br |
| data-fillout-popup-size | medium |
| data-fillout-inherit-parameters | true |
<a href="#" class="button"
data-fillout-id="7z8nKUGg5Jus"
data-fillout-embed-type="slider"
data-fillout-slider-direction="right"
data-fillout-domain="forms.novosconceitos.com.br"
data-fillout-popup-size="medium"
data-fillout-inherit-parameters="true">Pré-inscrição 2027</a>Este HTML é o resultado esperado. No Designer, o mesmo é obtido pelo painel de atributos personalizados.
<div data-fillout-id="b1NZtHXriRus" data-fillout-embed-type="slider" data-fillout-slider-direction="right" data-fillout-inherit-parameters data-fillout-domain="forms.novosconceitos.com.br" data-fillout-popup-size="medium"></div>
<script src="https://server.fillout.com/embed/v1/"></script>| Nome | Valor |
|---|---|
| data-fillout-id | b1NZtHXriRus |
| data-fillout-embed-type | slider |
| data-fillout-slider-direction | right |
| data-fillout-domain | forms.novosconceitos.com.br |
| data-fillout-popup-size | medium |
| data-fillout-inherit-parameters | true |
<a href="#" class="button"
data-fillout-id="b1NZtHXriRus"
data-fillout-embed-type="slider"
data-fillout-slider-direction="right"
data-fillout-domain="forms.novosconceitos.com.br"
data-fillout-popup-size="medium"
data-fillout-inherit-parameters="true">Faça sua pré-inscrição</a><div data-fillout-id="po77tNaSfGus" data-fillout-embed-type="slider" data-fillout-slider-direction="right" data-fillout-inherit-parameters data-fillout-domain="forms.novosconceitos.com.br" data-fillout-popup-size="medium"></div>
<script src="https://server.fillout.com/embed/v1/"></script>| Nome | Valor |
|---|---|
| data-fillout-id | po77tNaSfGus |
| data-fillout-embed-type | slider |
| data-fillout-slider-direction | right |
| data-fillout-domain | forms.novosconceitos.com.br |
| data-fillout-popup-size | medium |
| data-fillout-inherit-parameters | true |
<a href="#" class="button"
data-fillout-id="po77tNaSfGus"
data-fillout-embed-type="slider"
data-fillout-slider-direction="right"
data-fillout-domain="forms.novosconceitos.com.br"
data-fillout-popup-size="medium"
data-fillout-inherit-parameters="true">Faça sua pré-inscrição</a><div data-fillout-id="pmmyY4NaCvus" data-fillout-embed-type="slider" data-fillout-slider-direction="right" data-fillout-inherit-parameters data-fillout-domain="forms.novosconceitos.com.br" data-fillout-popup-size="medium"></div>
<script src="https://server.fillout.com/embed/v1/"></script>| Nome | Valor |
|---|---|
| data-fillout-id | pmmyY4NaCvus |
| data-fillout-embed-type | slider |
| data-fillout-slider-direction | right |
| data-fillout-domain | forms.novosconceitos.com.br |
| data-fillout-popup-size | medium |
| data-fillout-inherit-parameters | true |
<a href="#" class="button"
data-fillout-id="pmmyY4NaCvus"
data-fillout-embed-type="slider"
data-fillout-slider-direction="right"
data-fillout-domain="forms.novosconceitos.com.br"
data-fillout-popup-size="medium"
data-fillout-inherit-parameters="true">Faça sua pré-inscrição</a><div data-fillout-id="nhcZKpt3hpus" data-fillout-embed-type="slider" data-fillout-slider-direction="right" data-fillout-inherit-parameters data-fillout-domain="forms.novosconceitos.com.br" data-fillout-popup-size="medium"></div>
<script src="https://server.fillout.com/embed/v1/"></script>| Nome | Valor |
|---|---|
| data-fillout-id | nhcZKpt3hpus |
| data-fillout-embed-type | slider |
| data-fillout-slider-direction | right |
| data-fillout-domain | forms.novosconceitos.com.br |
| data-fillout-popup-size | medium |
| data-fillout-inherit-parameters | true |
<a href="#" class="button"
data-fillout-id="nhcZKpt3hpus"
data-fillout-embed-type="slider"
data-fillout-slider-direction="right"
data-fillout-domain="forms.novosconceitos.com.br"
data-fillout-popup-size="medium"
data-fillout-inherit-parameters="true">Faça sua pré-inscrição</a>Aba Network, filtro por fillout, com o cache desativado.
Somente o arquivo embed/v1 deve aparecer. Nenhuma requisição para forms.novosconceitos.com.br pode ocorrer enquanto ninguém clicar.
O painel deve entrar pela direita, com o formulário da unidade correta, e o restante da página deve continuar navegável ao fechar.
Acesse a página com utm_source=teste na URL, abra o formulário e confirme, no Fillout, que o parâmetro chegou junto com o envio.
Na aba Network, anote o total transferido antes e depois da mudança. A diferença é o ganho entregue ao cliente.
Excluir o bloco Embed com a div do Fillout das páginas da unidade.
Adicionar https://server.fillout.com/embed/v1/ uma única vez no Footer code do projeto.
Selecionar o Button ou Link Block e preencher os atributos personalizados com o data-fillout-id da unidade.
Usar # no campo de link para impedir navegação ao clicar.
Testar no domínio publicado, confirmando que o formulário só carrega no clique e que os parâmetros da URL são herdados.
Sim. Cada elemento com os atributos vira um gatilho independente. O script é incluído uma única vez no rodapé e atende a todos os botões da página.
O slider abre um painel lateral que entra pelo lado definido em data-fillout-slider-direction. O popup abre uma janela centralizada. A mecânica de acionamento por botão é idêntica nos dois casos.
Provavelmente os atributos foram aplicados a uma div, que o script trata como container de renderização. Mova os atributos para um Button ou Link Block.
Códigos personalizados de projeto não são executados no preview do Designer. O comportamento real só aparece no domínio publicado, incluindo o endereço de homologação webflow.io.
Sim, desde que data-fillout-inherit-parameters esteja presente com valor true e o clique no CTA não provoque recarregamento da página.
Conheça a plataforma e veja como aplicamos esses princípios na prática.
Conhecer a Kria