Badges
Badges allow administrators to automatically recognize learner achievements based on predefined rules. When a learner completes the actions specified in a badge rule, the badge is awarded automatically.
How Badges Work
Every badge consists of:
- Title – The name displayed to learners.
- Description – A brief explanation of the achievement.
- Badge Image – The visual icon representing the badge.
- Assignment Rule – Defines when and to whom the badge should be awarded.
Frappe Learning currently supports three badge assignment methods:
- Quiz Completion
- Course Completion
- Training (Batch) Completion
Assign a Badge for Quiz Completion
You can automatically reward learners when they successfully complete a quiz.
Each quiz submission creates a new LMS Quiz Submission record, making it the ideal event for badge assignment.
Configuration
| Setting | Value |
|---|---|
| Event | New |
| Reference DocType | LMS Quiz Submission |
| User Field | Member |
| Example Condition | Award the badge only when the learner scores 100%. |
Enable the Grant Only Once option if you want learners to receive the badge only the first time they meet the criteria.
Award a Perfect Score badge whenever a learner submits a quiz with a score of 100%.
Assign a Badge for Course Completion
Course completion is tracked through the LMS Enrollment document. As learners progress through a course, the progress field is updated.
Configuration
| Setting | Value |
|---|---|
| Event | Value Changed |
| Reference DocType | LMS Enrollment |
| User Field | Member |
| Field to Check | progress |
| Condition | doc.progress == float("100.0") |
Once the learner reaches 100% progress, the badge is awarded automatically.
Award a Course Completion badge when a learner finishes every lesson in a course.
Assign a Badge for Training Completion
Training programs are managed through Batches. Since individual batch progress is not tracked, training badges are assigned using the Auto Assign event.
Configuration
| Setting | Value |
|---|---|
| Event | Auto Assign |
| Reference DocType | Batch Student |
| User Field | Student |
| Condition | Specify the target batch using a JSON condition. |
Example condition:
{
"parent": "CLS-03050"
}
Replace CLS-03050 with the Batch ID for which the badge should be awarded.
Automatically award a Training Completed badge to every learner enrolled in a specific batch once they qualify for the configured rule.
Summary
Badge automation helps recognize learner achievements without manual intervention. Administrators can configure rules based on quiz submissions, course completion, or batch participation to reward learners consistently and encourage engagement throughout the learning journey.
