# Ranking

> The community's gamification. How many points each action is worth, the nine levels, the ranking periods, the Ranking space, how to turn on the global ranking and where to change the points.

The **Ranking** turns participation into points. Each action is worth a number of points, points add up to levels, and the Ranking space shows who takes part the most. Gamification is already turned on when the community is created.

## What it's for

| Community | How the ranking helps |
|---|---|
| Online school | Rewarding the students who complete the most lessons and help out in the comments |
| Customer community | Recognizing who answers the most questions |
| Company HR | Driving participation on the culture board |

## How it works

### What earns points

The default values, which the owner and admins change under **Members › Gamification**:

| Action | Points |
|---|---:|
| Create post | 10 |
| Like post | 1 |
| Comment on post | 5 |
| Reply to comment | 3 |
| Participate in event | 20 |
| Create event | 20 |
| Create course | 30 |
| Enroll in course | 10 |
| Complete lesson | 25 |
| Receive like | 2 |
| Daily login | 1 |

### The levels

| Level | Points |
|---|---|
| 1 | 0 to 99 |
| 2 | 100 to 299 |
| 3 | 300 to 599 |
| 4 | 600 to 999 |
| 5 | 1,000 to 1,999 |
| 6 | 2,000 to 3,499 |
| 7 | 3,500 to 5,999 |
| 8 | 6,000 to 9,999 |
| 9 | 10,000 or more |

### The periods

The ranking can be viewed for **This Week** (7 days), **This Month** (30 days) and **All Time**. Besides the community's **General Ranking**, a Ranking space can show the **Section Ranking**: participation in that section only.

### The Ranking space

The space shows the **Leaderboard**, the **Top Contributors**, **My Ranking** (the viewer's position, with progress toward the next level) and an explanation of how points and levels work.

### Turning it on and off

In **Settings › General**, the **Global Ranking** switch (*"Enable the global ranking leaderboard for all members"*).

### Changing the points

Under **Members › Gamification**, the owner and admins turn points on or off and change how much each action is worth. The new value applies from the next action on. See [Gamification](/membros/gamificacao).

## Step by step: create the Ranking space

*Role: owner or admin.*

1. **Add Space › Ranking**, **Next**.
2. Title (e.g. *Ranking*), icon and visibility (usually **Members**).
3. **Create Space**.

## Examples with numbers

**A student in one week.** Completes 4 lessons (100), comments 6 times (30), replies to 5 comments (15), logs in on 7 days (7) and receives 10 likes (20): **172 points**, moving from level 1 to level 2.

**An event.** Whoever creates the event earns 20; each attendee, 20.

## Frequently asked questions

**Are points worth money?**
No. They're recognition. If you want to give prizes, arrange the prize with the community (a free month, a gift).

**Can I reset the ranking?**
The **This Week** and **This Month** periods already restart on their own.

**Do staff members appear in the ranking?**
Yes, like anyone else who takes part.

## In the API

`GET /api/gamification/leaderboard`, `GET /api/gamification/score`, `GET /api/gamification/actions`, `GET`/`PUT /api/gamification/config`. See [Gamification](/api/referencia/gamification).

## Related

- [Gamification](/membros/gamificacao)
- [Feed](/espacos/feed)
- [Courses](/espacos/cursos)
- [General settings](/configuracoes/configuracoes-gerais)