---
title: "Creating Achievements to Motivate Learners"
slug: "create-achievements-to-motivate-learners"
tags: ["NFR"]
updated: 2024-09-27T15:36:19Z
published: 2024-09-27T15:36:19Z
canonical: "docs.skillable.com/create-achievements-to-motivate-learners"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skillable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Achievements to Motivate Learners

Achievements are a feature to recognize an accomplishment with the TMS platform. An achievement is automatically triggered by an action being completed in the platform, such as, a user launched a lab, completed a lab, completed a Course or a set of courses. You can create achievements that your students earn automatically through their Skillable TMS Activities and use them to motivate your students, especially if associated with external Badges. Users can choose to participate in achievements from their profile.

## Achievement Terminology

There are several terms (fields) you will need to know before you start to create achievements:

- **Points** - the point value you set based on the achievement's value compared to other achievements you have for your Organization. This number is completely up to you. You can create achievements that are earned based on the number of points a student has earned from other achievements.
- **Frequency** – the number of times an achievement may be earned.
- **Frequency Type** – qualifies the frequency. You can select from one of the following options:
  - **Per User** - each student can earn the achievement up to the **Frequency** number set;
  - **Per Day** - only one student can earn the achievement within the **Frequency** number of days;
  - **Per Achievement** - the achievement can only be earned the **Frequency** number of times total.
- **Conditions** - the conditions for earning the achievement. They are written in JSON.

## Create an Achievement

To create an achievement:

1. On the **Admin** menu, select **Achievements** in the **Organization** group.
2. On the **Find Achievements** page, select **Create Achievement** on the upper right side.
3. On the **Create Achievement** page, complete the **Basic Information** tab:
  1. **Name**
  2. **Description**
  3. **Organization**
  4. **Points**
  5. **Frequency**
  6. **Frequency Type**
4. (Optional) Next to **Badge**, click **Choose** to open the **Choose Badge** dialog if the achievement will earn the student a badge from the outside Badge Provider.
5. Search for and select the badge and select **OK**.
6. Select the **Conditions** tab and enter the JSON conditions for earning the achievement.
7. Select **Save**.

## Track Achievements

Once you have created achievements and have your students set to participate in them, you can track the achievements they are earning from either a user's Profile or from the Find Achievements page. To access the achievements of a student:

1. On the User Profile page, select **Achievements** in the toolbar. This opens a page displaying all achievements the user has earned. This link is only available if your organization has achievements AND the user is participating. To track who has earned a specific achievement, use the **Find Users** search page. On this page:
2. From the **Add filter** dropdown, add the **Achievement** filter.
3. In the **Choose Achievement** dialog, select the achievement you want and click **OK**. All of your users who have earned the achievement will be listed in the results.

## User Requirements for an Achievement

The following settings must be in place for the user to earn an achievement:

1. Your organization must have the **Enable Achievements** field checked on the Preferences tab. This enables your users to earn achievements.
2. A user must have the **Participate in Achievements** field checked on the **Basic Information** tab of their profile.
3. The achievement must belong to the organization the user belongs to OR the course must have the **Enable achievements for outside**Organizations checked.

Achievements are a feature to recognize an accomplishment with the TMS. An achievement is automatically triggered by an action being completed in the platform, such as, a user launched a lab, completed a lab, completed a course or a set of courses. An achievement can be associated with a badge so that the badge is automatically assigned when the task is completed.

Bundles together content to then be set up for training through classes, subscriptions, and course assignments. Courses can include labs, videos, SCORM, LTI, external links, assessments, and documents. Courses must be assigned to a Content Provider and a Publishing Group to be available to set up for training.

Skillable's Training Management System. A learning management system designed to streamline the delivery, tracking, and reporting of your training programs.

Activities are configured in the instructions editor and represented in the lab instructions by a replacement token. Activities fall into two broad categories: Questions and Automated.

- Questions are multiple choice or short answer questions.
- Automated Activities interact with the lab environment (Virtual Machine/Container/Cloud Platform).

Badges are digital credential for completing a class or a course which can be assigned manually on the class roster or course assignment. When paired with an Achievement the badge can be automatically triggered by a set of actions such as completing a course or launching a lab. Badges are provided through Credly/Acclaim and can be shared on social media or as email signatures.

People who interact with the platform. Typically, we can break down users into three categories: Operations Managers, Instructors and Basic Users..

An organization is assigned to each entity in the TMS, such as, users, classes, subscriptions, and courses. The organization is a basis to determine access given based on roles within the organization and management over the organization.

The user profile contains information about the user and their preferences, including roles, managed organizations, and settings.

Participate in achievements is an option on the user profile allowing the user to opt in or out of earning achievements.

Organizations are the containers in which all objects in Skillable Studio reside. Each organization has two child orgs, Development and Production. Development is used for content creation and testing. Production is used only for content that is ready for consumption. Organizations also provide one of the security boundaries within the Skillable Studio platform.
