Estes guias descrevem o Toimii depois que ele estiver no ar. O painel e a cobrança ainda não estão disponíveis — o Toimii será lançado em 2026.

Como incorporar um formulário de contato no Wix (guia honesto para 2026)

O widget Embed do Wix corre num iframe em sandbox — por isso colar tudo de uma vez não funciona. Aqui está o método dividido que funciona.

<script src="https://cdn.toimii.io/components/your-code.js" async></script>
<toimii-contact></toimii-contact>

Isto funciona mesmo?

Sim — mas apenas com o método dividido, no plano Core ou superior.

O bloco "Embed a Widget" do Wix corre num iframe em sandbox. Em dezembro de 2025, o Wix reforçou essa sandbox ao remover allow-same-origin — por isso colar tudo de uma vez já não funciona. A tag script carrega dentro do iframe, onde não consegue ver o DOM da tua página Wix, e o elemento personalizado regista-se no sítio errado.

A solução é o método dividido: coloca a tag script em Definições → Código Personalizado (que injeta diretamente na tua página Wix, NÃO dentro de um iframe), e coloca a tag do elemento personalizado <toimii-contact></toimii-contact> num bloco Embed a Widget. O script regista o elemento na página pai, o bloco widget coloca a tag, e o formulário aparece.

Passo a passo

Abre Definições → Código Personalizado

No painel Wix, vai a Definições → Código Personalizado (em Avançado). Nota — requer o plano Core ($17/mês) ou superior. Clica em + Adicionar Código Personalizado.

Adiciona a tag script

Cola apenas a tag script — a primeira das duas linhas: <script src="https://cdn.toimii.io/components/your-code.js" async></script>. Define "Adicionar Código às Páginas" para "Todas as Páginas" (ou apenas a página onde estás a incorporar o formulário). Define "Colocar Código em" como Body — início. Guarda.

Adiciona um bloco Embed a Widget

Abre o Editor Wix para a página onde queres o formulário. Clica em Adicionar (+) → Embed Code → Embed a Widget. (NÃO Embed HTML — essa é a versão em sandbox.) Coloca o widget onde o formulário deve ficar.

Cola a tag do elemento personalizado

Nas definições do widget, cola apenas a tag do elemento personalizado — a segunda linha: <toimii-contact></toimii-contact>. Clica em Atualizar.

Dimensiona o bloco widget

Redimensiona o bloco widget no Editor para aproximadamente a altura do formulário. O formulário em si aparece fora do iframe (na tua página Wix) — o bloco widget serve como âncora de posicionamento.

Publica e vê ao vivo

Clica em Publicar. A pré-visualização por si só não mostra o formulário — as regras de Código Personalizado só funcionam em versões guardadas/publicadas. Vê o URL ao vivo para confirmar.

Plano necessário

Definições → Código Personalizado requer o plano Core ($17/mês) ou superior. O plano gratuito e o plano Light podem usar o Embed a Widget mas não têm Código Personalizado, por isso o método dividido não funciona — precisas de fazer upgrade.

Problemas comuns

Colar tudo num único widget Embed NÃO funciona. O Wix reforçou a sandbox do Embed em dezembro de 2025 (removeu allow-same-origin). O script carrega, mas o elemento personalizado regista-se dentro do iframe — não na tua página Wix.
Definições → Código Personalizado requer o plano Core ($17/mês) ou superior. O plano gratuito e o plano Light não o têm.
As regras de Código Personalizado aplicam-se ao guardar — não aparecem na pré-visualização do Editor Wix. Clica em "Pré-visualização" ou, melhor ainda, em "Publicar" e vê o URL ao vivo.
O bloco Embed a Widget tem um tamanho de iframe fixo. Redimensiona o bloco no Editor para a altura natural do formulário; o formulário em si fica FORA do iframe (na página pai), por isso o iframe é apenas uma âncora de posicionamento.
Se as tuas regras de código personalizado entrarem em conflito, a gravação mais recente vence silenciosamente. Mantém uma regra, orientada para ambas as páginas, em head + body — mais fácil de depurar do que regras separadas por página.

Perguntas frequentes

O que significa "iframe em sandbox"?

Um iframe em sandbox é um iframe com o atributo sandbox, que restringe o que o conteúdo interior pode fazer. Em dezembro de 2025, o Wix removeu allow-same-origin da sandbox do widget Embed. O script ainda carrega, mas o elemento personalizado regista-se dentro do iframe — não na tua página Wix. É por isso que um único bloco de embed não funciona; temos de o dividir.

Porque é que "Embed HTML" já não funciona como antes?

Ambos correm no mesmo iframe em sandbox (desde que o Wix reforçou a segurança em dezembro de 2025 ao remover allow-same-origin). O script carrega, mas o elemento personalizado regista-se no iframe — não na tua página pai. É por isso que recomendamos o método dividido.

Espera — o método dividido funciona mesmo?

Sim. A tag script vai em Definições → Código Personalizado (head ou body) — isso é uma injeção na página pai, não num iframe. O elemento personalizado vai num bloco Embed a Widget, que renderiza a tag na página pai (o conteúdo do widget corre no iframe mas a tag em si é montada no DOM pai). Juntos: o script regista o elemento na página pai, a tag está no DOM pai, o formulário aparece.

E o Velo (Wix Dev Mode)?

O Velo (Wix Dev Mode) dá-te código backend e eventos frontend — mas a superfície de renderização para HTML continua a ser o mesmo iframe do widget Embed. O Velo não levanta a sandbox; apenas te dá uma forma de scripting à volta dela. Para a maioria dos utilizadores, o método dividido é mais simples.

Devo simplesmente mudar para outra plataforma?

Honestamente, se estás agora a escolher um construtor de sites sem código, o Squarespace, o Webflow e o WordPress.com suportam todos o nosso embed de forma mais limpa do que o Wix. Não dizemos isto levianamente — preferimos que tenhas uma experiência tranquila a que lutes com a sandbox.

A incorporar noutra plataforma?

As mesmas duas linhas de código, explicadas para cada plataforma.

WordPress

Bloco HTML Personalizado, Block Editor ou Clássico. Sem instalar plugin. Um detalhe — o teu perfil de utilizador precisa da permissão unfiltered_html.

Ler o guia completo

Squarespace

Coloca um Bloco de Código em qualquer página. Requer o plano Core (renomeado Business em 2025) ou superior.

Ler o guia completo

Webflow

O elemento Code Embed suporta até 50 000 caracteres. O código personalizado requer o plano Basic ou superior. Publica para pré-visualizar.

Ler o guia completo

Shopify

Adiciona uma secção Custom Liquid a qualquer tema — sem instalar app. Salta as páginas de checkout a menos que estejas no Shopify Plus.

Ler o guia completo

Sites Estáticos

Astro, Hugo, 11ty, Jekyll — as mesmas duas linhas no teu template de layout. As builds ficam rápidas.

Ler o guia completo

HTML / Personalizado

Uma página HTML simples chega. Abre num editor de texto, cola, guarda, faz upload. Três passos e está online.

Ler o guia completo

React / Vue / Angular

Usa o elemento personalizado diretamente em JSX, templates Vue ou componentes Angular. Sem componente wrapper, sem pacote extra.

Ler o guia completo

Pronto para experimentar?

30 dias de teste gratuito. Sem cartão de crédito. Pronto em minutos.

Sem cartão de crédito. Pronto em 2 minutos.