After you buy on Lemon Squeezy
Lemon Squeezy handles checkout and issues a Lemon license key. Use that key only when you register on the License Portal (together with your email and a portal password). After signup, the portal generates the Composer token (cmp_…) and Public API key (pk_forms_…) you actually use to install and activate Flex Forms.
The Lemon key is not a Composer password and not the key you paste into Filament.
Complete checkout
Find your Lemon license key
Create the portal account
- your email (same as Lemon checkout when possible),
- a password for the portal,
- your Lemon license key.
cmp_…) and Public API Key (pk_forms_…). The Lemon key is only for this registration (and later Change license key) — never for Filament or Composer auth.Grab the generated credentials
- Composer token (
cmp_…) — for Installation - Public API Key (
pk_forms_…) — for Activate license / Setup Wizard
cmp_… like a password. pk_forms_… is safe to store in Filament Global Settings; it only unlocks hosts you whitelist.Register hostnames
pk_forms_… into Filament.Portal sections (what each one is for)
Use this map when you are inside the dashboard. Every section has a single job.Install via Composer (cmp_…)
cmp_… value — update every server and CI job in the same change window.
Public API Key (pk_forms_…)
pk_forms_… per environment.
Domains list (license activations / seats)
pk_forms_… alone is not enough if the browser host is missing — details in Activate license.
Change license key
Regenerate Composer token
Seat limits by plan
Each registered hostname consumes one license activation (seat), including staging and local hosts you add to the portal. Full feature comparison: Plans & pricing. Need more seats than your plan allows? Upgrade via the store, then Change license key in the portal.Inactive vs Active Lemon status
Lemon Squeezy and the License Portal both surface status language that customers often misread. Here is what it usually means for Flex Forms.Inactive (common right after purchase)
When Lemon shows the license as inactive and you have not registered any domains yet:- The purchase is typically valid
- Zero hostnames have been activated against that key
- Composer / portal access for a healthy account is not the same thing as “this Lemon row says inactive”
- Your next step is: open the portal → add the first domain → then paste
pk_forms_…into Filament
Active
After domains are registered and entitlement checks succeed, Lemon / portal status moves toward an active (in-use) picture:- At least one activation is associated with the license
- Filament hosts on the whitelist can validate against your Public API key
- Plan features (seats, hide branding where applicable) apply on successful checks
When something is actually wrong
Treat these as real entitlement problems (not the normal “inactive until first domain” case):- Purchase cancelled, refunded, or expired (yearly plan not renewed)
- Account banned or otherwise blocked by support
- Portal / Composer messaging that downloads are disabled (see FAQ below)
pk_forms_….
Credential reference
Keep these four items mentally separate. Mixing them is the most common install / activation mistake.Day-to-day workflows
Access the dashboard
Install the package
cmp_… from Install via Composer, configure Composer auth, then follow Installation.Unlock Studio
pk_forms_…, register hostnames, then paste the key via Setup Wizard or Activate license (Global Settings → License).Swap or add domains
Upgrade the plan
Troubleshooting & FAQs
Can I regenerate my Composer token if it leaks?
Can I regenerate my Composer token if it leaks?
cmp_… is revoked immediately. Update every auth.json, Forge env, and CI secret that still uses the previous token, then run Composer again on each environment.Do I need a unique Public API key for every domain?
Do I need a unique Public API key for every domain?
pk_forms_…) covers all domains registered under your account. Add each hostname to the domains list; keep pasting the same pk_forms_… into each Filament install (or share one key across environments that use the same portal account).What happens if the License Portal goes offline?
What happens if the License Portal goes offline?
Composer says downloads are disabled — when does that happen?
Composer says downloads are disabled — when does that happen?
Lemon still says inactive after I paid
Lemon still says inactive after I paid
I upgraded but seats did not increase
I upgraded but seats did not increase
Studio is locked even though I pasted pk_forms_…
Studio is locked even though I pasted pk_forms_…
cmp_… or the Lemon key). See Activate license and Setup Wizard.