Skip to content

Settings

Settings are at Basin → Settings, for admins. Like other plugin settings, they’re saved in project config, so they deploy with your site. Any of them can also be set in config/basin.php, which overrides the Control Panel.

Setting Default What it does
Account API key — An environment variable holding your Basin Account API key, e.g. $BASIN_API_KEY. See Connecting Basin.
Basin project — The project whose forms this site uses. Choose it from your projects, or choose an environment variable that holds its ID.
Menu label Basin How the plugin appears in the Control Panel menu, e.g. “Forms”.
Show unread count On Shows the number of unread submissions next to the menu item, for users who can view submissions.
Allow permanent deletion of submissions Off When off, submissions can only be moved to the trash. When on, users with the Permanently delete submissions permission can delete them from Basin for good.
Add spam protection automatically On Adds the CAPTCHA and honeypot each form requires to every Basin form on your site. See Spam protection.
reCAPTCHA version v3 Which reCAPTCHA to show for forms that require it: v3 (invisible) or v2 (the “I’m not a robot” checkbox). A form can choose its own.
Cache duration 300 How long, in seconds, to cache your forms and their settings from Basin.
Track missing forms On Records forms the site uses but can’t show, such as a form that isn’t in the linked project, in the error log.

A few settings belong to a single form and are changed on the form’s page under Basin → Forms: its Form Studio embed code, and its reCAPTCHA version. These are saved in the database, not project config, so they can be changed on your live site without a deployment. They need the Set up forms on this site permission.

A form’s own settings are kept in Basin. Its notifications, redirect, auto-reply and retention can be changed from the Control Panel; spam settings and webhooks are changed in Basin itself.