O widget Form é um único elemento: conecte uma coleção, escolha campos e rótulos, e deixe os visitantes enviarem — incluindo uploads de imagem, vídeo e Media Gallery. Você pode dividir formulários longos em etapas, mostrar campos só quando uma condição for atendida, criar um contato Wix, registrar um membro do site e acionar Wix Automations. No Pro, você também pode cobrar no envio via Wix Checkout.
Tutorial em vídeo
O que você pode fazer
- AI setup — descreva campos e textos de envio em linguagem simples; veja AI setup
- Texto, Number, URL, dropdowns, telefone (E.164 com código de discagem do país), Color (seletor nativo de cor; salva HEX), seletores Date / Date & time / Time, imagens, upload de Video e multi-upload de Media Gallery
- Radio buttons e Checkbox (multi-seleção) em campos de texto, com opções personalizadas
- Multi-step form — divida o formulário em páginas com Next / Back e progresso; Preview step no editor
- Show only when — oculte um campo até que outro esteja vazio, não vazio ou coincida com valores selecionados
- Autosave — salva enquanto a pessoa digita; membros retomam um rascunho na coleção e os demais guardam um rascunho neste navegador até enviar
- Rótulos de envio em um único painel (substitui widgets separados Text Input / Dropdown / Submit Button / Form Dataset das versões iniciais)
- Update displays on this page — após um envio bem-sucedido, os widgets Table, Repeater, Slideshow, Media Gallery, Calendar, Chart e Dynamic Page na mesma página que usam a mesma coleção recarregam automaticamente
- Contacts — Create contact, Update existing contact e Assign contact labels (Pro)
- Members — Create member, mais Assign Badges e Add to groups (Pro)
- Spam & bot protection (Pro) — Use reCAPTCHA, Honeypot field e Limit submission rate
- Wix Automations — gatilho Form submitted após cada envio bem-sucedido
- Payments (Pro) — pay-on-submit: salva o envio, abre o Wix Checkout e depois grava os detalhes do pedido de volta no envio
Configuração
Use AI setup no painel para um começo em linguagem simples e depois refine no Manual. Detalhes: AI setup.
- Adicione Form em Add → Elements → Installed Apps → CMS for Harmony (você pode adicioná-lo mais de uma vez).
- Conecte uma coleção que deve receber os envios.
- Escolha os campos e rótulos que os visitantes preencherão (campos Number e URL recebem tipos de entrada correspondentes).
- Opcionalmente ative Multi-step form em Steps e atribua campos no Field setup; configure Show only when por campo.
- Opcionalmente ative Update displays on this page, Create contact, Create member, Spam & bot protection (Pro) e/ou Enable payments (Pro) — veja abaixo.
- Publique e teste um envio no site ao vivo (ou na prévia). O checkout de pagamento roda no site ao vivo.
Os envios chegam à sua coleção para que você possa exibi-los depois com Table ou Repeater, se quiser. Com Update displays on this page, uma lista na mesma página é atualizada assim que o envio é concluído.
Steps
- Ative Multi-step form na seção Steps.
- Adicione etapas e defina cada Step title.
- Em Field setup, atribua cada campo a um Step.
- Use Preview step no editor para ver uma página por vez no canvas.
- No formulário ao vivo, visitantes usam Next / Back; o envio roda na última etapa.
Field setup
Para cada campo, configure Label, Placeholder, Required e Input type. Campos de texto admitem Radio buttons e Checkbox (multi) com Options personalizadas. Com multi-step ativo, atribua o Step. Show only when oculta o campo até que outro esteja vazio, não vazio ou Equals any of valores selecionados — Required só vale enquanto o campo está visível.
Hidden fields {#hidden-fields}
Requisitos: plano Pro.
Em campos de coleção Text e URL (não referências nem add-ons):
- Ative Hidden field em Field setup.
- Escolha Value source: Fixed text, URL query param ou Page URL (URL completa no envio, com query string).
- Para URL query param, defina o nome do parâmetro e fallback opcional se faltar.
- O campo não aparece no site ao vivo e é preenchido no envio (inclui Autosave). Required e Show only when não se aplicam enquanto estiver oculto.
- No editor, badge Hidden e hachura. Sem Pro, voltam entradas normais.
Não use para segredos — valores são visíveis no navegador.
After Submit {#after-submit}
Em Submit, After Submit controla o que acontece quando o envio é bem-sucedido:
| Opção | Comportamento |
|---|---|
| Stay on Page (padrão) | Mostra a mensagem de sucesso e mantém o visitante no formulário. |
| Navigate to Page | Abre outra URL após o envio. |
Com Navigate to Page, escolha Navigate to:
- Dynamic page URL — Monta a página do item recém-criado ou atualizado (mesmo padrão de Page path / Item slug dos links de Dynamic Page). Use para «enviar e abrir o novo anúncio».
- Enter manually — Defina uma URL fixa (por exemplo
/thank-youou um link absoluto).
A navegação ocorre após um envio bem-sucedido. Se uma Dynamic page URL não puder ser resolvida, o formulário permanece na página e mostra a mensagem de sucesso.
Update displays on this page
No painel do Form, ative Update displays on this page. Após um envio bem-sucedido, os widgets Table, Repeater, Slideshow, Media Gallery, Calendar, Chart e Dynamic Page na mesma página que usam a mesma coleção recarregam automaticamente — assim os visitantes veem o item novo ou atualizado sem atualizar o navegador.
Autosave
Em Submit, ative Autosave para salvar enquanto o visitante digita. Editable form e Autosave não podem ficar ativos ao mesmo tempo.
- Ative Autosave.
- Escolha um Submitted field (boolean). Use Add submitted field para criar um chamado Submitted se a coleção ainda não tiver. Esse campo não aparece no formulário.
- Membros precisam de Read e Update nos próprios itens (o painel oferece Fix quando essas permissões faltam).
Membros salvam um rascunho na coleção com o submitted field em false. Abrir o formulário de novo retoma esse rascunho. Submit atualiza o mesmo item e define o campo como true. Filtre listas por esse campo quando quiser ocultar rascunhos incompletos.
Visitantes que não estão logados guardam o rascunho neste navegador até enviar. O envio grava um item novo na coleção e limpa o rascunho do navegador.
O formulário mostra Saving…, Saved ou Couldn’t save. Keep editing — we’ll try again. Senhas não são armazenadas no rascunho.
Contacts
Use a seção Contacts no painel do Form para criar ou atualizar um contato Wix quando alguém envia.
- Ative Create contact.
- Mapeie Email (obrigatório) e quaisquer slots opcionais: Phone, First name, Last name, Full name, Company, Job title.
- Prefira campos da coleção quando também quiser salvar os valores no CMS. Use Add field (contact) para campos só do formulário que não vão para a coleção — o painel mostra uma nota curta e Add to collection se mudar de ideia.
- Para limpar um mapeamento opcional, use o X ao lado do dropdown. Limpar um mapeamento de Add field (contact) também remove esse campo só do formulário. Email continua obrigatório enquanto Contacts estiver ativo, então não tem controle de limpeza.
- Opcionalmente ative Update existing contact para que um e-mail coincidente atualize esse contato em vez de criar um novo.
- Opcionalmente ative Assign contact labels (Pro) e escolha rótulos do CRM de Contacts do site. Os rótulos são aplicados após Create contact.
- Publique e envie uma entrada de teste; confirme que o contato aparece nos Contacts do seu site.
Quando Create member está ativo, Contacts permanece habilitado para login email e campos de perfil continuarem mapeados.
Members
Use a seção Members para visitantes criarem uma conta de membro do site no envio.
- Ative Create member (também habilita Contacts).
- Defina Login email (obrigatório) — mapeie um campo de e-mail da coleção ou Add field (member).
- Mapeie quaisquer outros slots de contato que quiser no membro/contato (mesmo mapeamento de Contacts).
- No formulário ao vivo, visitantes veem Password e Confirm password (rótulos/placeholders editáveis em Field setup). Senhas nunca são gravadas na coleção.
- Opcionalmente ative Assign Badges (Pro) e escolha badges em Site members.
- Opcionalmente ative Add to groups (Pro) e escolha Wix Groups. Badges e grupos são aplicados após o envio quando um membro é criado ou encontrado pelo login email.
- Publique e teste o cadastro no site ao vivo.
Spam & bot protection {#spam—bot-protection}
Requisitos: plano Pro. Sem Pro, esses interruptores ficam desligados no site ao vivo mesmo que tenham sido salvos antes.
Reduza envios automatizados. Abra Spam & bot protection e ative qualquer combinação:
- Use reCAPTCHA — Visitantes confirmam que são humanos com Google reCAPTCHA (chaves Enterprise da Wix). Tokens são verificados no envio e também cobrem o registro Create member quando esse recurso está ativo. Escolha When to show reCAPTCHA:
- Always — desafio visível no formulário.
- For suspected bots — verificação invisível no envio; a maioria dos visitantes não vê desafio.
- Honeypot field — Adiciona um campo armadilha oculto que bots costumam preencher. Visitantes reais não o veem; envios com esse campo preenchido são rejeitados.
- Limit submission rate — Limite suave de cerca de 8 envios por minuto do mesmo visitante nos servidores do app.
Envios rejeitados ou limitados mostram um erro curto no formulário e não são salvos na coleção.
Wix Automations
Cada envio bem-sucedido do Form reporta um evento Form submitted ao Wix Automations (best-effort; não bloqueia salvar o envio).
Em Automations, escolha o gatilho Form submitted do CMS for Harmony. O payload inclui submission id, collection id, submitted time, payment-pending flag, uma string JSON dos valores dos campos e — quando Contacts está mapeado — email, name, phone e contact id quando disponível.
Use para notificações por e-mail, repasse a CRM ou qualquer ação de Automations que você já usa no site.
Form payments (Pro)
Os pagamentos do Form são separados dos pagamentos de catálogo (Add to cart / Buy now nas exibições). Aqui o visitante paga um valor fixo ou informado ao enviar o formulário.
- Conecte uma coleção e abra a seção Payments no painel do Form.
- Ative Enable payments (instala o Wix Stores se necessário).
- Defina Item name (item de linha no checkout).
- Escolha Price: Fixed amount ou Visitor enters amount (adiciona um campo Amount obrigatório no formulário ao vivo).
- Defina a Label do botão de pagamento.
- Em Save to submission, use Add fields (ou mapeie manualmente) para Order ID, Total paid e Payment status — preenchidos após o checkout quando o pagamento for bem-sucedido.
- Publique e teste no site ao vivo.
Sem Pro, o interruptor de pagamentos fica desligado e o painel mostra um aviso de upgrade.
FAQ
Can the form navigate after a successful submit?
Yes — After Submit can Stay on Page or Navigate to Page (Dynamic page URL or manual URL). See After Submit.
Can forms block spam?
Yes on Pro — reCAPTCHA, honeypot, and submit rate limit under Spam & bot protection.
Can forms create contacts or members?
Yes — Create contact / Create member, with optional labels, badges, and groups. See Contacts and Members.