Troubleshooting
Every submission is rejected or goes to spam
Section titled “Every submission is rejected or goes to spam”- The form requires a CAPTCHA, and the page doesn’t have one. Check that Add spam protection automatically is on, or that the template calls
form.captcha(). If you turned the CAPTCHA on in Basin recently, clear Basin data under Utilities → Caches, and purge any statically cached pages. - Turnstile without keys. Turnstile needs your own Cloudflare keys in the form’s spam settings in Basin, and every domain the form is used on must be added in Cloudflare.
- Submissions marked “failed_recaptcha”. reCAPTCHA v3 scores visitors, and Basin files low scores as spam. Automated browsers and some privacy tools score low. Check the spam tab, and consider v2 or Turnstile for that form.
A form doesn’t appear on the page
Section titled “A form doesn’t appear on the page”craft.basin.form() returned null, which means the form isn’t in the linked project. Check Basin → Error log in the Control Panel: the form may have been deleted or moved to another project. See Missing or moved forms.
For a Form Studio form, check that its embed code has been added, and that your site’s domain is in the form’s Allowed Domains setting in Basin. In devMode, a notice appears in its place if the embed code is missing.
Submissions don’t appear in the Control Panel
Section titled “Submissions don’t appear in the Control Panel”- Check that the form is in the project linked in the settings. A form moved to another project keeps accepting submissions, but this site no longer shows them.
- Lists are cached for up to a minute. Reload, or clear Basin data under Utilities → Caches.
“Couldn’t connect to Basin”
Section titled ““Couldn’t connect to Basin””- Check the key with Test connection under Basin → Settings.
- Check that the environment variable is set on this environment (for example, that
.envon the server hasBASIN_API_KEY). - If Basin is down, the front end keeps working from a saved copy of your forms, and the Control Panel shows when the data is from.
CAPTCHA blocked by Content Security Policy
Section titled “CAPTCHA blocked by Content Security Policy”Allow the CAPTCHA provider’s scripts and frames in your policy. See Content Security Policy.