How do I create badges?

Note: This document references views and actions that are only available to Echo Administrators.

Create badges

Badges can be awarded to recognize and encourage students, and they are rapidly becoming the standard in competency-based learning for recognizing and tracking mastery.

Echo allows for two types of badges:

  • Automatic badges are configured to be automatically awarded to students by Echo when they complete an activity, unit, or course.
  • Teacher-assigned badges are configured to be assigned by teachers to reward a specific achievement or behavior. Teachers can choose from badges in specific categories (e.g., leadership, scholarship, service, etc.) and provide personalized comments and/or evidence, so students know why they're being recognized.

To create both types of Badges:

  1. Open the side menu in Domain > Details.  
  2. Select Edit Settings.
  1. Click Add on the Badges card (click on existing badges to edit them).
  1. Provide:
    • The badge Name (required; 128 character limit).  
    • A badge Image.
      • Required file type: PNG
      • Ideal size: 90x90
    • Description of what the badge represents (required; 128 character limit).
    • The Requirements for earning the badge.
    • The Issuer Name, Organization, and Contact E-mail Address.
  2. Save badge.

Personalize badges with replacement variables

Echo allows you to set up automated personalization for badges. To do so, insert any of the variables listed in the table below into text fields where you want the content customized for the user. At the time of giving the award, Echo replaces the variables by drawing the content described in the table from the domain or course.

For example, text in an automatic badge's Requirements field reading "To earn this badge, students must complete the {{ITEMTITLE}} Activity.", would read "To earn this badge, students must complete the Diorama Activity." When awarded for completing a folder named "Diorama."

Keep in mind that the Name and Description fields have a 128 character limit; if the replacement variable data that is pulled in causes either field to exceed that limit, the text will be truncated.

Review the table for descriptions of your variable options.  

Variable Description
{{IMAGEENTITYID}}
The ID of the entity that owns the badge image resource.
{{IMAGEPATH}}
The path of the image resource.
{{BADGEID}}
The ID of the badge generated by the server.
{{USERID}}
The ID of the user received the badge.
{{FIRSTNAME}}
The first name of the user.
{{LASTNAME}}
The last name of the user.
{{DOMAINID}}
The ID of domain of the user.
{{DOMAINNAME}}
The name of the domain of the user.
{{USERSPACE}}
The userspace of the domain of the user.
{{ENROLLMENTID}}
The ID of the user's enrollment in the course that contains the item the user has completed.
{{COURSEID}}
The ID of the course.
{{COURSETITLE}}
The title of the course.
{{ITEMID}}
The ID of the item the user has completed.
{{ITEMTITLE}}
The title of the item.

Echo is constantly being improved based on the feedback from users and we strive to keep our documentation up to date.  If this document doesn't match what you are seeing in Echo, please let us know.

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.