Skip to main content
Global Settings is the installation-wide control panel for Flex Forms. Every form inherits these defaults. Open it from the Flex Forms left rail (gear icon). Settings are split into vertical tabs with icons — use the tab that matches the job. Google Analytics, Mapbox, reCAPTCHA, and other third-party credentials live under Integrations, not here.

​
Tabs at a glance

Deep links keep the active tab in the URL (for example ?tab=mail, ?tab=security, or ?tab=insights).

​
How Global Settings is organized

​
Setup workflow

1

Open Global Settings

In the Flex Forms left rail, click Global Settings.
2

Appearance

Set the Site name used as the brand in submission notification emails (leave empty to use your app name). Set the Studio primary color and theme (auto / light / dark). Pick the Studio admin language — public fill language is still per form under Form Settings → General. See Localization & RTL.
3

Mail

Upload an email logo for team alerts (header and footer). If you skip this, emails show your Site name as text instead. Images are converted to WebP and fitted into a square box (default max edge 600px). When Spatie Media Library is enabled for Flex Forms uploads, the same Spatie path is used.
4

Security

Optionally enable Require encryption on all forms so every form encrypts submission answers at rest. Equivalent hard policy via env: FLEX_FORMS_FORCE_SUBMISSION_ENCRYPTION=true (locks the toggle on). Per-form control: General Settings → Encrypt submission answers. Multi-tenant recipe: Multi-tenancy.
5

License

Open the License tab. This is the permanent home for your Public API key (same value the Setup Wizard collects on first run).Field: License public key
Placeholder: pk_forms_…
Expected format: pk_forms_ + exactly 32 hexadecimal charactersHow to fill it:
  1. Sign in to the License Portal (register with email + password + your Lemon key if you have not yet — the portal then generates pk_forms_… and cmp_…).
  2. Copy Your Public API Key (pk_forms_…) — not Install via Composer (cmp_…) and not the Lemon key.
  3. Paste into License public key, save Global Settings, reload the browser.
  4. Confirm the hostname in the address bar is listed under your portal domains. Staging, production, and local *.test hosts are separate seats.
Without a valid key + matching hostname, Studio save/publish stays locked, but this Global Settings page remains reachable so you can always recover.Full walkthrough, seat limits, and troubleshooting: Activate license. Portal reference: License Portal.
Do not paste your Lemon Squeezy license key or cmp_… into this field. Lemon is only for portal registration; Composer uses cmp_…; Filament uses the portal-generated pk_forms_….
6

Public URLs

Enable a custom prefix early (e.g. forms, s) if you want fill URLs under /{prefix}/{slug}.
Changing the prefix after forms are already shared breaks existing live links.
7

Insights (production / high traffic)

Leave Redis on Auto unless your host team asked for a specific profile. Turning Redis On accelerates Insights unique counts (TodayBuffer / HyperLogLog). It does not own the shared Flex Forms plugin cache by default — set FLEX_FORMS_CACHE_REDIS_MODE=follow_insights (or on) if you want Studio / integration / fill cache on that Redis connection. Details: Redis production guide and Redis scaling.
8

Integrations (separate page)

API keys for Mailchimp, Mapbox, Google Analytics, and the rest are configured under Integrations in the same left rail — not inside Global Settings. See the Integrations catalog.
Fail-safe access: Global Settings stays reachable even if the license is missing or invalid, so you can always paste a new public key and recover the install.
Last modified on September 7, 2026