Como acionar o formulário Fillout pelos botões nativos do Webflow

    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.

    9 min de leitura WebflowAtualizado em 10/08/2026

    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.

    1. O que muda e por que muda

    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.

    Ganhos diretos

    • O formulário só é baixado quando a pessoa clica, o que tira peso relevante de JavaScript da primeira carga.
    • O CTA passa a seguir a identidade visual do site, sem o botão flutuante padrão do Fillout.
    • É possível ter vários CTAs na mesma página apontando para o mesmo formulário.
    • Os parâmetros de campanha continuam sendo herdados da URL, porque não existe recarregamento de página.

    2. Receita padrão, válida para as cinco unidades

    1. 1

      Remova o embed antigo da página

      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.

    2. 2

      Inclua o script uma vez no rodapé do projeto

      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.

    3. 3

      Selecione o botão que vai abrir o formulário

      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.

    4. 4

      Adicione os atributos personalizados

      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.

    5. 5

      Ajuste o link do botão

      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.

    6. 6

      Publique e valide no domínio publicado

      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 único, no rodapé do projeto

    <script src="https://server.fillout.com/embed/v1/"></script>

    Project settings > Custom code > Footer code. Uma vez por projeto.

    Atributos comuns a todas as unidades

    Nome do atributoValorFunção
    data-fillout-embed-typesliderAbre o formulário em painel lateral, sobre a página.
    data-fillout-slider-directionrightDefine o lado de entrada do painel.
    data-fillout-domainforms.novosconceitos.com.brUsa o domínio próprio do formulário, e não o domínio padrão do Fillout.
    data-fillout-popup-sizemediumLargura do painel.
    data-fillout-inherit-parameterstrueRepassa ao formulário os parâmetros presentes na URL da página, como as UTMs.

    3. Colégio Academia

    Embed atual, a ser removido da página

    <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>

    Atributos a aplicar no botão

    NomeValor
    data-fillout-id7z8nKUGg5Jus
    data-fillout-embed-typeslider
    data-fillout-slider-directionright
    data-fillout-domainforms.novosconceitos.com.br
    data-fillout-popup-sizemedium
    data-fillout-inherit-parameterstrue

    Referência do HTML publicado

    <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.

    4. Colégio Arnaldo Anchieta

    Embed atual, a ser removido da página

    <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>

    Atributos a aplicar no botão

    NomeValor
    data-fillout-idb1NZtHXriRus
    data-fillout-embed-typeslider
    data-fillout-slider-directionright
    data-fillout-domainforms.novosconceitos.com.br
    data-fillout-popup-sizemedium
    data-fillout-inherit-parameterstrue

    Referência do HTML publicado

    <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>

    5. Colégio Arnaldo Funcionários

    Embed atual, a ser removido da página

    <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>

    Atributos a aplicar no botão

    NomeValor
    data-fillout-idpo77tNaSfGus
    data-fillout-embed-typeslider
    data-fillout-slider-directionright
    data-fillout-domainforms.novosconceitos.com.br
    data-fillout-popup-sizemedium
    data-fillout-inherit-parameterstrue

    Referência do HTML publicado

    <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>

    6. Colégio Verbo Divino

    Embed atual, a ser removido da página

    <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>

    Atributos a aplicar no botão

    NomeValor
    data-fillout-idpmmyY4NaCvus
    data-fillout-embed-typeslider
    data-fillout-slider-directionright
    data-fillout-domainforms.novosconceitos.com.br
    data-fillout-popup-sizemedium
    data-fillout-inherit-parameterstrue

    Referência do HTML publicado

    <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>

    7. Colégio Sagrado Coração de Maria

    Embed atual, a ser removido da página

    <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>

    Atributos a aplicar no botão

    NomeValor
    data-fillout-idnhcZKpt3hpus
    data-fillout-embed-typeslider
    data-fillout-slider-directionright
    data-fillout-domainforms.novosconceitos.com.br
    data-fillout-popup-sizemedium
    data-fillout-inherit-parameterstrue

    Referência do HTML publicado

    <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>

    8. Armadilhas conhecidas

    • Elemento errado: se o gatilho for uma div, o script volta a criar o botão flutuante e a montar o formulário no carregamento. Use Button ou Link Block.
    • Link ativo: um botão apontando para uma página real navega antes de o painel abrir. Use # como destino.
    • Atributo booleano sem valor: o Webflow descarta atributos vazios na publicação. Use true em data-fillout-inherit-parameters.
    • Elementos criados depois do carregamento, como itens de slider, abas ou modais montados por script, podem não receber o disparo. Nesses casos, prefira posicionar o CTA em conteúdo estático ou reexecutar a inicialização após a criação do elemento.
    • Cópia de componente: ao duplicar um botão em Symbol ou Component, os atributos vão junto. Confirme se a unidade correta está no data-fillout-id de cada projeto.
    • Teste no Designer: custom code do projeto não roda no preview. Sempre valide no site publicado.

    9. Como validar a entrega

    1. 1

      Abra a página publicada com o DevTools

      Aba Network, filtro por fillout, com o cache desativado.

    2. 2

      Confirme o carregamento zero antes do clique

      Somente o arquivo embed/v1 deve aparecer. Nenhuma requisição para forms.novosconceitos.com.br pode ocorrer enquanto ninguém clicar.

    3. 3

      Clique no CTA

      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.

    4. 4

      Verifique a herança de parâmetros

      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.

    5. 5

      Compare o peso da página

      Na aba Network, anote o total transferido antes e depois da mudança. A diferença é o ganho entregue ao cliente.

    Passo a passo

    1. 1

      Remover o embed em div

      Excluir o bloco Embed com a div do Fillout das páginas da unidade.

    2. 2

      Incluir o script no rodapé do projeto

      Adicionar https://server.fillout.com/embed/v1/ uma única vez no Footer code do projeto.

    3. 3

      Aplicar os atributos no CTA

      Selecionar o Button ou Link Block e preencher os atributos personalizados com o data-fillout-id da unidade.

    4. 4

      Definir o destino do botão como sustenido

      Usar # no campo de link para impedir navegação ao clicar.

    5. 5

      Publicar e validar

      Testar no domínio publicado, confirmando que o formulário só carrega no clique e que os parâmetros da URL são herdados.

    Perguntas frequentes

    Posso usar vários botões na mesma página apontando para o mesmo formulário?+

    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.

    Qual a diferença entre slider e popup?+

    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.

    O formulário abre sozinho ao carregar a página. O que houve?+

    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.

    Por que preciso testar no site publicado?+

    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.

    As UTMs continuam chegando ao formulário?+

    Sim, desde que data-fillout-inherit-parameters esteja presente com valor true e o clique no CTA não provoque recarregamento da página.

    Conteúdos relacionados

    Quer ver a Kria em ação?

    Conheça a plataforma e veja como aplicamos esses princípios na prática.

    Conhecer a Kria