How do I create badges?

Ryan Richins
  • Agilix team member
  • Updated:

Personalize your student reward program with Buzz; it's easier than ever!


  • This article reflects updates made to the badge creation process on April 14, 2016. Learn more.

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.

Buzz allows for two types of badges:

  • Automatic badges are configured to be automatically awarded to students by Buzz 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 vertical menu in the toolbar of Domain Details.  
  2. Select Domain 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
    • A 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

Buzz 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, Buzz 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.

Personalize badges with replacement variables

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.

Comments (2)

Sort by
Jeff Lockard

Is it possible to batch load badges for multiple domains or is this a one badge/file per domain at a time operation?

0 Comment actions Permalink
Scott Taylor

Hello Jeff,

Badges can only be created one at a time in a domain, however badges created at a higher level domain will propagate to subdomains under that domain.

0 Comment actions Permalink
Please sign in to leave a comment.