Using the Level Up! Block

Article Last Updated June 2021

The Level Up! Block is a new block in eClass that can be used to add gamification elements to your course. This block will allow you to capture and attribute 'experience points' to actions that students take in your course.

Once configured, the block will allow you to specify which actions within your course will allow students to gain experience points and progress to higher levels once a set amount of points have been reached. You can also use badges to provide visual notifications congratulating students as they advance!


To add the Level Up! Block to your course:

  1. Click on Turn editing on, near the top right corner of the page.

  2. Scroll down to the bottom left and click on the Add a block button.

  3. A pop-menu appears. Select Level up!.

    select level up block

  4. Once the block has been added, you will have access to it at the bottom-right of the screen (underneath your other blocks). Note that you can change both the Title and the Description of the block by clicking on the gear icon in the top-right corner of the block and selecting Configure Level up! block. Make sure that you click on the Save changes button once you are done to ensure that your title/description changes are applied.

    level up block
    change title

Getting Started - Block Settings

Once the Level Up! block has been added to your course, you can click on any of the available links in the bottom of the block to access specific sections of the block's configuration settings. Note that students will only have access to the 'Information' link by default unless you make specific settings to change the links available. To continue the setup of the block, click on the Settings link.

click settings to continue

By default, the block will be configured to allow students to access the information tab, gain experience points, and receive popup notifications when they level up. To disable any of these features, you can alter the settings in the 'General' section. You can also choose to enable the ladder setting to grant students access to view a course ladder where students are ranked by their experience points. The settings available here will allow you to alter the anonymity of ladder-based information that students can view. Please note that you can click on the help bubbles available beside each setting to read a specific description of the setting.

general settings

You will also be able to configure settings to frame how and when student actions that generate experience points will be regulated and capped. To do this, you can alter the 'Cheat Guard' settings to specify the maximum student actions that will count for experience points, as well as the minimum time required between identical actions that will award experience points. You can also choose to enable/disable logging for the block, which will keep action logs for experience point actions for the specified period of time.


Setting up Rules

Once you have configured your general settings, use the top navigation bar to access the 'Rules' tab. In this section, you can begin adding rules that will award students experience points for the actions they take in your course. To begin, click on the Add a rule link:

adding rules

When adding a new rule, you will first need to set the number of experience points that will be awarded to the student upon taking the action you will specify. You will also need to set whether ANY, ALL, or NONE of the conditions listed below the rule you are adding need to be true in order for the experience points to be awarded.

Once this is done, you can add one or more CONDITIONS to your rule:

adding conditions


  1. Specific Event:
    Choose this condition to award experience points for specific events, grouped by the activity/resource within which the event occurs. Events that indicate that a student has participated within a resource or activity (ie. Viewing, Posting, Updating, Submitting etc) are great candidates to receive experience points.
  2. Activity or resource:
    Choose this condition to award experience points for a SPECIFIC activity or resource in your course. Note that only existing/available activities in your course will be available for selection. It is important to note that this condition should only be used in conjunction with a specific event condition as only applying an activity or resource condition will award the listed experience points for ALL actions within the selected activity/resource.
  3. Set of conditions:
    This option allows you to add a new sub-branch to your rule that contains multiple conditions (for which you can require ANY, ALL, or NONE of the conditions to be met).
  4. Event Property: (Advanced Users/Programmers Only)
    These conditions refer to properties and are not recommended for most users. They allow you to award experience based upon a large number of system-side event properties, which are more familiar to advanced users and developers.


Once your desired conditions have been created and you have assigned experience points to the rule, make sure that you click on the Save Changes button at the bottom of the screen. Note that rules become active once they have been created and saved and that you can remove or adjust the number of experience points that rules award at any point during your course.

Notes About Setting Rules

The rules in the Level Up! block are based on user logs. You may need to create a more general rule to allow for XP to be gained easier or a stricter rule if XP is granted too easily. If you are unfamiliar with how to read logs, please contact IST eClass Support for further information.

A typical setup for awarding points for a specific click/activity requires the following order of the conditions:

  1. Event
  2. Activity / Resource

If you specify only the activity or order the Event after it, students will receive duplicated points.


Setting Levels

Once you have set up your rules, you may also want to adjust the default set of levels that students can attain by clicking on the Levels tab in the menu. Here, you can adjust the amount of achievable levels and alter the amount of experience points required to attain each level. Note that the block uses a built-in algorithm by default that will need to be disabled in order to add your own manually entered numbers.

Whether you use the default algorithm or make your own levels, it is important to make sure that the XP required for each level aligns with the amount of XP your students will earn by taking actions within your course.


As always, make sure that you save your changes at the bottom of the page before navigating away. Also, please note that changing the levels after experience points have already been awarded within the course will automatically recalculate the levels of all users.


Using the Ladder

The ladder tab allows you to view a RANKED list of students by level/experience points. This view can be displayed to students to varying levels of anonymity via the settings tab.


Incorporating Badges Using the Visuals Tab

If desired, you can associate images to the various levels that students can achieve using the 'Visuals' tab in the horizontal menu. To do this, go to the Visuals tab and change the 'Use custom level badges' setting to 'Yes'.

You can then upload image files with the following naming conventions to associate the image to each of your levels:

[level].[file extension]

For instance, you would name your level 1 image file "1.png"

The recommended image size for level images is 100x100px.

visuals tab


Additional Tabs

The horizontal menu bar will also grant you access to the following tabs:

  • Information - This section allows you to view a table that outlines the levels, required experience points for each level, and any level descriptions you have added. Note that this is the only default tab that is viewable to students.
  • Log - This section allows you to view the logs of experience point changes in your course, up to a maximum set of days configurable in the Settings tab.
  • Report - This section provides you with a table that outlines the names, levels, experience points, and overall progress of your students. You can also use the gear icon beside any student to manually change their number of experience points.


(0 vote(s))
Not helpful