Manage Levels

Create levels to define how users progress along your program's engagement scale. Nitro has one leveling system which applies to all users. You cannot set up different levels per group.

When creating levels, consider how you want to reward users for level achievement.

Reward using missions only. When using this strategy, do not add an image to the level. Instead, create a mission that rewards the level achievement (see an example). When using this setup, users see the mission's badge in their trophy case. They can earn points when reaching a level and view the completed mission's details.
Reward using the level only. When using this strategy, add an image to the level. As users level up, the level's badge displays in their trophy case. They can earn the level badge, but no points or mission completion.
Reward using the level and a mission. When using this strategy, add an image to the level. Then, create a mission that rewards the level achievement (see an example). When using this setup, users see both the level and mission's badge in their trophy case. They can earn a badge, points, and view the completed mission's details. However, unless you use different imagery, the user will see a duplicate badge in their trophy case (level and mission).

Create a Level

Open Nitro Studio > Reward > Levels.
Select your level type:
- Points - Assign levels automatically based on the user's lifetime point balance. When the point balance reaches a certain threshold, the user graduates to the next level. Levels are based on the default point category.
- Custom - Assign levels manually via API calls. You can use custom levels to assign levels based on user achievements.
Click New level. Or, to edit an existing level, hover over the level and click Edit ().
Set level properties:

Field	Description
Level name	The name of the level.
Level points	The number of points a user needs to earn to reach this level (Points type levels only).
Level description	A description of the level. Descriptions only appear in Nitro Studio.
Action phrase	Deprecated. The action phrase was shown in the Events web component.
Thumbnail image	The URL to the image that represents this level. If no image is defined, only the level name displays in relevant messaging. See Program Imagery for recommended image sizing.

Click Save.
For Custom levels, set up your API calls to determine when users achieve new levels.

Delete a Level

Note: Deleting levels is not recommended.

When you delete a level from your program, any user currently at that level will return to the last level in their history. For example, Jess is at Level 1 and earns enough points to move to Level 3. If Level 3 is deleted, Jess will return to Level 1. However, if Jess progressed from Level 1 to Level 2 to Level 3 and then Level 3 is deleted, they will return to Level 2.

Troubleshooting

If you change a user's point balance by removing a mission completion or manually adjusting points, and this adjustment affects the user's level, the incorrect level may display until a point transaction takes place. For example, Jess earns Level 2. Then, you remove a mission completion that moves her back to Level 1. The UI will show Jess at Level 2 until the next point transaction occurs.