Troubleshooting
Sections don't appear in the editor
- Confirm the theme is activated on the product (not just uploaded to Saved Templates).
- Sections live under the Gamify category in *Add Section*.
Badge never unlocks
- The badge's Module ID must exactly match the lesson's complete-button value
(data-gk-complete, defaults to post.id).
- For
XP thresholdbadges, check the threshold vs XP per lesson ร lessons. - Badge state is per-browser in Local mode โ a new device starts fresh. Use Pro for
cross-device sync.
Progress bar shows 0 but I completed lessons
- The bar reflects Kajabi's native completion, which updates server-side. Reload the page
after Kajabi records the completion. (XP updates instantly; progress % follows Kajabi.)
Confetti doesn't play
- Expected if the device has Reduce Motion enabled โ this is intentional (accessibility).
Leaderboard says "Pro feature" / is empty
- Leaderboards need Pro: set Mode = Pro and paste your API base + key
(Theme settings โ Gamification). See pro-setup.md.
- Empty leaderboard = no synced students yet.
Pro: nothing syncs
- Both API base URL and API key must be set, or the kit falls back to Local (check the
browser console for a [GamifyKit] warning).
- Verify the key matches a row in
gamify_buyer.
Quiz gate never opens
- v1 (Local): quiz gates show locked by design. Real pass-detection requires Pro + a Kajabi
automation posting to the webhook. See pro-setup.
After uninstalling, a page looks off
- Re-activate your previous theme on the product; GamifyKit adds sections but doesn't modify
your Kajabi content.
Still stuck? Contact support (see your purchase email) with your site URL and the affected page.
