How do I bulk award badges to learners in Canvas Badges?
Canvas Badges allows program administrators to bulk award badges 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.
Once a badge has been awarded, its data is unchangeable. If you're 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.
Notes:
- You must create an issuer and badge before bulk awarding badges.
- Canvas Credentials subscribers have unlimited bulk awards. If using Canvas Badges (free), you are limited to 50 awards per CSV file.
- Manual or bulk awarded badges do not appear in the Canvas Credentials LTI unless you have purchased a Canvas Credentials subscription.
Download Sample CSV File
To learn how to structure the data in your CSV file, click the Download the sample CSV link.
View Sample CSV File
The CSV file may contain several fields. The Identifier field (email address, URL, or phone number) is the only required field.
- Badge Class ID: Unique identifier for the badge to be awarded. This is the ID in Mongo which is also available in the URL (e.g. 65f803ac53ae0b2639ac0eba) [1]
- Identifier (email address, URL, or phone number) [2]
- First Name [3]
- Last Name [4]
- Narrative [5]
- Evidence Narrative [6]
- Evidence URL [7]
- Issue Date [8]
- Expiration Date [9]
Upload CSV File
Once your CSV file is prepared according to instructions, you may upload it by dragging and dropping your CSV file to the Upload File field [1] or you can click the Select File to Upload link [2].
View a preview of your uploaded CSV file [3].
Click the Next button [4].
Map CSV File Column Headers
If the first row of the CSV file has column headers, make sure the First row has column headers checkbox is selected [1].
To map the column headers in your CSV file to the column headers in Canvas Badges, use the drop-down menus for each column header [2].
Click the Next button [3].
Issue Bulk Award Badges
Once uploaded, Canvas Credentials analyzes the data to map column headers. You may be able to customize notifications settings if allowed by your organization and/or the Prevent Duplicate Badge Awards checkbox (if applicable) [1]. After validation, click the Finish button [2].