Troubleshooting

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 threshold badges, 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](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.