Note: You are currently viewing documentation for Moodle 3.10. Up-to-date documentation for the latest stable version of Moodle may be available here: Managing badges.

Managing badges

From MoodleDocs

Badges may be managed at the course or site level. (Note that teachers in a course cannot by default access site badges unless they have been given a system role with badge managing capabilities) For information on adding course or site badges, see Using badges. Individual users can manage their badges from their profile.

Managing course badges

  • If course badges have been enabled by the administrator then a teacher will see a Badges section from the More link when clicking the cog icon (Boost theme) or from Badges in the course administration block (non-Boost themes).
  • New badges may be added by clicking the 'Add a new badge' button, while clicking the name of an existing badge allows you to view its details and make changes if it is not enabled.
The Managing badges screen

When the initial details have been added and the badge uploaded, clicking to continue leads to the screen where the criteria must be set along with extra information.

The badge must only be enabled once all necessary settings have been added.

Badge information

Support for Open Badges 2.0 means badges may now include language and version, image author details (in the initial set up) and Endorsements, Related badges and Competencies.

Useful information

  • Fields which are not completed (such as Endorsements. Related badges etc) will not be shown on the badge page.
  • Versions of badges make it easy to keep track of badges over a period of time or badges at different levels or languages.
  • Endorsements are third party accreditations (official or unofficial) such as from an external body or the management of an institution, adding value to a badge by giving it their approval.
  • Related badges are badges which are linked in some way to the badge being awarded, for example on a similar topic or one of several levels (beginner, intermediate, advanced). They are shown as text only, not hyperlinks.
  • Moodle competencies may now be used as criteria for awarding badges.

Managing site badges

Badges are enabled by default in Site administration / Advanced features and can be managed from Site administration / Badges / Manage badges.

Criteria for awarding site badges are as follows:

  • Uploading a profile picture, as part of the profile completion criteria
  • To denote cohort membership
  • Dependent on previously awarded site badges (course badges can't be used)
  • Based on competencies

All existing badges are displayed in a table showing current badge image, name, status, criteria, how many users have already earned this badge and a set of available actions.

Other settings are the same as for course badges. Badges which have manual award among their criteria can be issued by one user to another. Users who issue a badge must have "moodle/badges:awardbadge" capability. Site administrators can choose their role when issuing a badge.

Deleting badges


Once a badge has been awarded, there are two options for deleting it, available by clicking the X icon for the badge in question from the Manage badges screen for site or course badges.

  1. Delete, but keep existing issued badges -if this option is chosen, then the badge will no longer be available but students who have earned the badge will still have it displayed on their profiles.
  2. Delete and remove all existing issued badges - if this option is chosen, then the badge will no longer be available and students who earned the badge will no longer have it displayed on their profiles.


Note: Even though the badge is deleted from Moodle, if a student has added it to an external backpack, it will still be visible online, although the award criteria will no longer be available.

Individual user badge management

Users may manage their site and external badges by clicking on the user menu top right > Preferences > Badges > Manage badges. From here, they can view, search for and download badges.

Example of a badges screen

This then displays "badges" in the profile.

In Preferences > Badges > Badge preferences users can decide whether to automatically display all badges earned.