---
title: Participation Policies
url: https://docs.kaltura.com/docs/events-collaboration/gamification-api/gamification-participation-policies
---

## Participation Policies

Participation policies control user visibility across all game objects (leaderboards, badges, certificates, lead scoring).

| Policy | Description |
|--------|-------------|
| `display` | User participates; progress visible to other users |
| `do_not_display` | User participates; progress visible only to admins |
| `do_not_save` | User does not participate; no data collected |

### 5.1 Matching Criteria

| Criteria | Description |
|----------|-------------|
| `byGroup` | Match by user group ID |
| `byEmailDomain` | Match by email domain |

Policies evaluate in array order. First match wins. If no policy matches, `userDefaultPolicy` applies.

```bash
curl -X POST "$KALTURA_SCM_URL/leaderboard/create" \
  -H "Authorization: Bearer $KALTURA_KS" \
  -H "Content-Type: application/json" \
  -d '{
    "objectType": "Leaderboard",
    "name": "External Only",
    "status": "scheduled",
    "startDate": "2025-06-01T00:00:00Z",
    "endDate": "2025-06-02T00:00:00Z",
    "participationPolicy": {
      "userDefaultPolicy": "display",
      "policies": [
        {"policy": "do_not_save", "matchCriteria": "byEmailDomain", "values": ["internal-company.com"]},
        {"policy": "do_not_display", "matchCriteria": "byGroup", "values": ["speakers"]}
      ]
    },
    "virtualEventIds": ["$VIRTUAL_EVENT_ID"]
  }'
```

In this example, internal employees are excluded entirely (`do_not_save`), speakers participate but are hidden from rankings (`do_not_display`), and all other users are visible (`display`).