Formpost

Reference

Troubleshooting

The handful of things that usually go wrong, and how to fix them.

Nothing arrives in my inbox

  • Check the spam folder — the first message from a new sender often lands there. Marking it as safe fixes it permanently.
  • Confirm the notification address in the dashboard is the one you expect.
  • Open the dashboard: if the submission is listed but flagged as spam, a keyword rule or heuristic caught it.
  • Check the response body. A failing request always explains itself in the message field.

The page navigates away when I submit

That is the browser's default behaviour for a form post. Either call event.preventDefault() and submit with fetch, or set a redirect URL so visitors land somewhere you control.

I get 403 domain not allowed

The form has domain locking on and the request's Origin did not match. Add the exact hostname — including any preview or staging domains — in the form settings, or clear the list to accept submissions from anywhere.

Everything is being marked as spam

Check the blocked keywords list for something too broad, and confirm your captcha secret matches the site key you render. A wrong secret makes every verification fail.

Attachments are missing from the email

File uploads need a paid plan, uploads enabled in the form settings, and enctype="multipart/form-data" on the form tag. Miss any one of those and the file is dropped while the rest of the submission goes through.