Skip to main content

Documentation Index

Fetch the complete documentation index at: https://empuls.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Engagement scoring controls the karma value of every tracked activity in Empuls. When an employee gives recognition, posts on the feed, completes a survey, or hits any other tracked event, they earn the karma points you’ve set here. Karma rolls up into the leaderboard, so getting these values right is what makes your leaderboard reflect the behaviors you actually want to promote. This page is also labeled Promotional Points in the admin menu — they’re the same setting. To open engagement scoring, navigate to Admin Hub → Manage Leaderboards → Engagement Score, or open it directly in your tenant at https://<your-empuls-url>/home/leaderboard/promotional-point.

Before you start

  • You must be a Super Admin or have leaderboard-management permission.
  • Karma values are organization-wide. You can’t set different values per department or per leaderboard cycle.
  • Changes apply going forward only — past events keep the karma value they had when they happened.

How karma flows into the leaderboard

1

An employee performs a tracked activity

For example, they send a recognition to a colleague or react to a post on the feed.
2

Empuls records the event

The event references one of the entries in the engagement-score table.
3

Karma is awarded

The karma value you set here is added to the employee’s leaderboard score for the active cycle.
4

Leaderboard updates

Custom leaderboards roll up karma per activity, per cycle. See Manage leaderboards for how leaderboards consume these scores.

Configure scores

1

Open Engagement Score

Navigate to Manage Leaderboards in the Admin Hub, then click Engagement Score (also shown as Promotional Points in some menus).
2

Review the table

The table has three columns:
  • Feature — The product area the activity belongs to (Recognition, Social Feed, Surveys, Townhall, Groups, and so on).
  • Activity — The specific event being scored (Send recognition, Like a post, Complete a survey, etc.).
  • Engagement Score — The karma value awarded each time the activity happens.
3

Edit a score

Click the edit icon next to a row. An input field opens with the current value.
4

Enter the new value

Type a whole number. Values must be integers; the input accepts up to 5 digits. Negative numbers are allowed if you want to penalize specific behaviors (rare).
5

Save or cancel

Click the check icon to save, or the cancel icon to discard the change. Save shows a “Karma value updated successfully” confirmation.
You can edit one activity at a time. Each save commits immediately — there’s no batch save.

Setting scores well

A few rules of thumb:
  • Higher karma for rarer, higher-value activities. Sending a thoughtful recognition is worth more than reacting to a post. Completing a 20-question survey is worth more than answering a single Mood-o-Meter question.
  • Avoid extreme spreads. If one activity gives 1,000 karma and another gives 1, leaderboards quickly fixate on the single high-value action. Keep most activities within roughly an order of magnitude of each other.
  • Pair with leaderboard cycles. Short cycles (weekly) reward consistent low-karma activity; long cycles (monthly/quarterly) let bigger activities like jury participation matter.
  • Audit periodically. Reweight after major program changes — for example, when launching surveys, give “Complete a survey” a temporary boost so the leaderboard pushes participation.

Common activities you can score

The exact list depends on which Empuls modules you have enabled, but typical entries include:
FeatureActivity examples
RecognitionSend a recognition, receive a recognition, give a value-based award
Social FeedCreate a post, react to a post, comment, share
TownhallPost in Townhall, comment in Townhall
GroupsCreate a group, post in a group
SurveysComplete a survey, complete a Pulse cycle
NominationsSubmit a nomination, approve a nomination, jury rate a nomination
CelebrationsPost on a wishboard, celebrate a colleague

Limits and gotchas

  • Karma values are org-wide and apply to all leaderboards that include the activity.
  • The change applies immediately, but already-awarded karma from past activities is not retroactively updated.
  • Engagement scoring does not issue reward points to employees — it awards karma for leaderboard ranking only. To grant reward points, use a budget, automated gifts, or peer recognition.
  • Activities with zero karma still appear in the leaderboard event feed; only the score is suppressed.