Troubleshooting

Fixes for the problems people hit most. Not sure what is wrong with your form? Paste it into the form checker.

I submitted the form but nothing shows in my inbox

Check the Spam view of the form first. A submission that looked automated is kept there, and you can move it back with one click.

Then check the form itself: the action must be your full endpoint (https://formtango.com/f/ followed by your form id), the method must be POST, and every field needs a name attribute.

If your account is over its monthly limit, new submissions are held rather than shown. The dashboard says so at the top, and upgrading releases them.

I get "Form not found" (404)

The form id in the address is wrong or the form was deleted. Open the form in your dashboard, copy the endpoint from the Setup tab, and paste it into the action attribute again.

A form created by an AI tool without an account is removed after 7 days unless someone opens its claim link.

Submissions arrive in the inbox but I get no email

Look in your spam or junk folder and mark the message as not spam. Emails come from no-reply@formtango.com.

Open the form's Notifications tab and check that notifications are on and set to "Right away" rather than a digest.

Extra recipients have to confirm their address first. Until they click the link in the confirmation email, nothing is sent to them.

Test submissions (sent with a _test field) never send email.

The submission is empty or some fields are missing

Browsers only send fields that have a name attribute. An input with only an id or a placeholder is left out.

Field names starting with an underscore are instructions to FormTango (such as _redirect and _gotcha), so they are not stored as data.

If you send the form with JavaScript, pass the form element to FormData: new FormData(form). Building the object by hand is where fields usually get lost.

The browser console shows a CORS error

The form endpoint accepts requests from any website, so a CORS error usually means the request never reached it: check the URL for typos and make sure it starts with https://.

If you listed allowed sites in the form's settings, the page you are sending from has to be on one of them. Add your local address while you are developing.

Only the form endpoint (/f/…) can be called from a browser on another site. The account API needs an API key and is meant for servers.

I get "Slow down a little" or another 429 error

One connection sent many submissions in a short time. This protects your form from floods. Wait a minute and try again.

While testing, add a _test field with the value 1. Test submissions are not counted against your plan and nobody is emailed, up to 50 a day per form.

"This form is at its limit" means the account has used its monthly submissions and its holding allowance. Upgrading the plan fixes it straight away.

A real message was marked as spam

Open the Spam view, select it and choose "Not spam". It moves to the inbox and is delivered as normal.

If your form is filled in by a script or an automated test, it may be sent faster than a person could type. Use a _test field for those.

Make sure the hidden _gotcha field stays empty. Some browser autofill tools fill in hidden fields; adding autocomplete="off" and tabindex="-1" to it prevents that.

File uploads are not working

The form tag needs enctype="multipart/form-data". Without it the browser sends only the file's name.

File uploads are part of paid plans. On the free plan the rest of the submission is saved and the files are left out.

A submission can carry up to 5 files and 4 MB in total. Common document, image, audio and video types are accepted; programs and scripts are not.

My thank-you page redirect does not happen

Redirecting to your own page is part of paid plans. On the free plan visitors see the FormTango thank-you page.

The address must be complete, starting with https://. Set it in the form's settings, or with a hidden field named _redirect.

If you send the form with JavaScript and ask for JSON, there is no redirect: your own code decides what happens next.

My webhook or Slack alert is not firing

Open the form's Connections tab and look at the delivery log. It shows each attempt and the response we got back.

A failed delivery is retried several times over about an hour and a half. You can also replay one by hand from the log.

The address must be public and use https. Addresses on a private network or localhost are refused; use a tunnel while developing.

I get the same submission twice

The visitor probably clicked the button twice. Identical submissions sent close together are filtered as duplicates, but a small change makes them different.

Disable the button while sending. The FormTango drop-in script and the React hook both do this for you.

Still stuck? Email support@formtango.com with your form id and what you see.