1. Badgr Knowledge Base
  2. Creating and Awarding Badges

Awarding badges to a group of recipients (in bulk)

Learn how to bulk award badges using a CSV file

Badgr allows program administrators to award badges (in bulk) to a group of recipients. You may include optional metadata such as evidence and narrative to the badge(s) that may be the same or specific to each user.
The first step to awarding a badge in bulk is to upload the list of recipients, then awarding the badge.

Prerequisite: You have created an Issuer and badges in Badgr (see Creating an issuer profile & Creating badges as an issuer).

Badgr Pro subscribers have unlimited bulk awards. If you are using the free version, you are limited to 50 awards per CSV file. 

Manual or bulk awarded badges won't appear in the Badgr for Canvas LTI unless you have purchased a Badgr Pro Subscription (see Tracking Externally Awarded Badges). 

Once a badge has been awarded, its data is baked and unchangeable. If you are made aware of a necessary change to a badge after it has been awarded to an individual (such as an error in the spelling of a name), you can make this change by first revoking the badge, and then awarding it again with the correct data.

Uploading a CSV File

  1. Login into Badgr.com and select the Issuers tab from the navigation bar at the top of the screen.
  2. Create a new issuer or select the Issuer you would like to award badges for.
  3. Select the badge you wish to award. You may also issue a badge to an individual from here.
  4. Select the Bulk Award from CSV button.
bulk award

From here, you may download a Sample CSV file to see how to structure the data.

Use the Sample Template as your guide, your first few times

download example

The CSV file may contain several fields, but only the Email field is required:
  1. Email (required)
  2. Recipient Name (optional)
  3. Narrative (optional)
  4. Evidence URL (optional)
  5. Issue Date (optional)
  6. Expiration Date (optional)


  1. Once your file is prepared according to instructions, you may upload it by dragging and dropping your file or you can use the file picker.

  2. Select the Next button. 

  3. Match the columns in your file to Badgr's system using the drop-down arrows and click the Next button.

  4. If there are problems with your CSV file, you may be presented with information about how to fix the problem(s).

  5. If so, adjust your file following the instructions and re-upload your file.

    Invalid Rows
Awarding a badge in bulk
  1. Now you are ready to issue the badge to multiple recipients.

  2. Be sure to click the Notify Recipients by Email box (if applicable).

  3. Be sure to click the Prevent Duplicate Badge Awards box (if applicable).

  4. When you are ready, click Finish.
  5. You will be returned to the badge detail page where you may view the recent and past Awards from the tab under the Issuer name.

bulk award final screen