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. |
Per-form settings
Section titled “Per-form settings”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.
Settings that live in Basin
Section titled “Settings that live in Basin”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.