Form submission failed

Public form shows an error or spinner never completes.

5 min readUpdated July 2026

Before you begin

Use this when a hosted form, embedded form, QR form, or kiosk form does not submit correctly or does not create a Contact / Lead.

Video walkthrough placeholder for troubleshooting failed Flowforce public form submissions.
Video: Troubleshoot public forms
Video walkthrough placeholder for troubleshooting failed Flowforce public form submissions.

Symptom

  • Visitor sees an error after submitting a lead capture form
  • Embed shows failed request or blank success state
  • Submission never appears on the form Responses tab
Public form error state after a visitor attempts to submit a Flowforce form.
Public form error state after a visitor attempts to submit a Flowforce form.
Embedded Flowforce form stuck or blank after submission.
Embedded Flowforce form stuck or blank after submission.
Successful public form submission thank-you state for comparison.
Successful public form submission thank-you state for comparison.

Common causes

  • Form is inactive or archived
  • Wrong publicId in embed URL (/f/[publicId])
  • Turnstile or bot protection failed
  • Rate limit or honeypot triggered
  • Required field or consent checkbox missing

Fix

  • Forms → open form → confirm status is Active
  • Copy embed code again from Forms → Embed — verify publicId
  • Test without ad blockers; allow challenges.cloudflare.com if using Turnstile
  • Retry from a normal browser session (not automated tools)
  • Check required fields and marketing consent settings match your embed

What you should see

After the fix, the visitor should see a success message and Flowforce should create or merge a Contact / Lead with the correct form source.

Still stuck?

  • Open Admin → Logs → Email logs if notification on submit fails
  • Note form publicId, timestamp, and browser console error for support

Ready to try this in FlowForce?

Start free — set up your workspace and follow along with this guide.