Hello, How can we help?

What this does

Create games, challenges, and leaderboards to motivate your team through competition and recognition. IMPACT's gamification engine uses formula-based scoring, tiered achievements, and automated award distribution.

Current access and functionality

• Verified against the current impact-web, impact-client, and impact-marketplace code on 2026-05-07.
• In impact-web, users must be signed in and working in an active workspace. Navigation and write actions are role-, permission-, and entitlement-aware; unavailable modules are hidden or disabled instead of being universally visible.

Before you start

• You must be an admin.
• Identify what behaviours or outcomes you want to incentivise (e.g., task completion speed, quality scores, KPI achievement).

Key concepts

Steps

Creating a game

1. Navigate to the Game section.
2. Click Create Game (or duplicate from a template).
3. Fill in the game details:
   • Name — the game title (supports multiple languages).
   • Description — what the game measures and how to win.
   • Icon — visual identifier for the game.
   • Effective From / To — when the game runs.
4. Configure metrics — select which data points are tracked.
5. Define the scoring formula (JSON):
   • The formula calculates a score from the selected metrics.
   • Use the Test Formula dialog to verify your formula produces expected results before launching.
6. Set up tiers — define achievement levels with score thresholds.
7. Define rewards — what participants earn at each tier.
8. Configure scheduling (CRON):
   • Set how often the game runs and recalculates scores (e.g., daily, weekly, monthly).
9. Submit for approval — games require admin approval before activation.
10. Once approved, the game goes live.

Setting up awards

1. Within a game, go to the Awards section.
2. Click Create Award.
3. Configure:
   • Images — badge or trophy visuals.
   • Rank type and value — who earns the award (e.g., top 3, all Gold tier members).
   • Schedule and duration — when awards are distributed and how long they are valid.
   • Minimum population — minimum number of participants required for the award to be issued (prevents awards in very small groups).
4. Awards are approved and distributed automatically based on the game schedule.

Viewing leaderboards

1. Go to Challenges from the navigation.
2. Select a game to see its leaderboard.
3. The leaderboard shows:
   • Rank — current position.
   • Score — calculated from the game formula.
   • Tier — current achievement level.
   • Participants — click to see participant details.
4. Leaderboards update each time the game runs its scheduled calculation.

Using game templates

1. When creating a game, choose From Template to start from a pre-built game.
2. Templates include pre-configured metrics, formulas, and tiers.
3. Customise the template to fit your specific needs.
4. You can also mark your own games as templates for reuse.

Tips

• Keep games simple at first — one or two metrics with a straightforward formula. Add complexity as your team gets used to the system.
• Use the Test Formula feature before launching. A broken formula means incorrect scores and frustrated participants.
• Set minimum population on awards to avoid meaningless awards (e.g., "1st place out of 1 participant").
• Gamification works best when it reinforces existing KPIs and goals, not when it creates competing incentives.
• Rotate games periodically to keep engagement fresh. A leaderboard that never changes becomes demotivating.
• Awards have expiry dates — use this to create seasonal or time-limited recognitions.
• Games feed into the broader performance picture. Achievement data contributes to IPA scoring.

Common issues

• Issue: Game is not running — Fix: Check that the game is approved, the effective period is current, and the CRON schedule is correctly configured.
• Issue: Scores are all zero — Fix: Verify the formula is correct using the Test Formula dialog. Also check that participants have data for the selected metrics.
• Issue: Awards are not being distributed — Fix: Check the minimum population requirement. If fewer participants than the minimum are active, awards are not issued.
• Issue: Leaderboard is not updating — Fix: Leaderboards update on the CRON schedule, not in real time. Check the game log for the last run timestamp and any error messages.

Related

• How to define and track KPIs
• How IPA scoring works
• How to customise your dashboard