## TL;DR

After a Free to Pro upgrade through checkout, the JS client cache can briefly hold Free entitlements: use the cache-refresh hook. Model seats as a configuration feature with a per-unit charge, not a metered feature. Without an active subscription, entitlement checks use fallback rules, which are likely wrong.

## Fix

1. After a Free to Pro upgrade through checkout, the JS client cache can briefly hold Free entitlements: use the cache-refresh hook.
   Expected: You see the expected output instead of the problem.
2. Model seats as a configuration feature with a per-unit charge, not a metered feature.
   Expected: You get the expected result; the problem is gone.

## When to use

- You are setting up or using this Stigg freemium gotcha feature.
- The symptom matches: provision the Free subscription at signup.

## When NOT to use

- Unrelated Stigg freemium gotcha issues (different feature, different failure).
- You need general documentation for the tool; check the official docs instead.

## Compatibility

Reported against Stigg freemium gotcha. Source: https://github.com/stiggio/skills/blob/HEAD/skills/stigg-recipes/references/freemium.md.

## Variant phrasings

### provision the Free subscription at signup

## Why it happens

Gating without an active subscription silently falls back to fallback rules.

## Edge cases

- If your error message differs even slightly, this is probably a different issue; search the exact text.
- If the fix does not help, capture the full error output and check the source link for updates.

## Source

https://github.com/stiggio/skills/blob/HEAD/skills/stigg-recipes/references/freemium.md