Data management for issuers and badge classes

The data management tab can be found when selecting an issuer from your account or viewing a badge class you have created as an issuer. The tab contains different options depending on whether you're viewing the issuer or the badge class.

Issuer data management: Export badge awards

The data management feature is a part of our paid Canvas Credentials subscription.

The data management tab on an issuer's page allows you to export badge awards to a CSV file from a designated time period. All badges awarded to all recipients within the designated time period will be listed in the CSV file.

Exporting a badge awards to a CSV file:

  1. While logged into your Canvas Credentials account, select Issuers from the top navigation bar. Select an issuer from the list.
  2. From the issuer's page, select the Data management tab.

3. Choose a start and end date to define the time period for the badge awards you would like to view. If you do not select a start and end date, then all badges awarded to all recipients will be included in the CSV file.

4. Select Export CSV

5. Choose a destination file on your device and select Save.

6. You can open the file in Excel or another spreadsheet program to view the badge award information.

Badge class data management: Replacing a badge class

The data management tab on a badge details page allows you to replace the badge you selected with a badge from a different Canvas Credentials server location, or from a different Open Badge compliant badging platform.

Once a badge has been updated, the old badge information, such as the image, criteria and description will be permanently replaced. You can edit the current badge but cannot revert it to the original version.

Before a badge is awarded, it is called a badge class or badge template. The badge class is the badge you find listed under an issuer which can be edited. Once a badge is awarded, it's called a badge assertion. Badge assertions have been baked with the badge metadata, such as the recipient's email identifier, badge information and award date. An assertion cannot be edited.

How to update and replace a badge
  1. While logged into your Canvas Credentials account, select Issuer from the top navigation bar. Select an issuer from the list.
  2. Select the badge you would like to update and replace.
  3. Select the Data management tab.

4. In a different tab or window, find the badge you wish to use to update and replace the badge you initially selected. This can be from a different Canvas Credentials server location, the same server but a different issuer or a different Open Badge compliant badging platform.

5. Save or copy the badge image, public URL or JSON from an awarded badge assertion. The image alone from a badge class from a different issuer will not contain the badge metadata necessary to replace a badge. A badge assertion's image is needed or the public page URL.

6. Go back to the tab containing the badge you wish to update.

7. Paste or upload the badge image, URL or JSON in the appropriate field. Select Continue.

8. A new window will appear, displaying how the updated badge will appear. You will not be able to revert the badge to its original form once it has been updated. Select Cancel to go back to the data management page, or Replace badge to update and replace the badge.

Once a badge has been updated, it cannot be converted back to the original. All information associated with the original badge will be lost when it is replaced with the new badge.

Previously awarded badges

Badges that were awarded before you updated and replaced the badge class will also be altered. The information in previously awarded badges will be re-baked with the updated badge information. The badge text typically will update right away; however, if the badge image differs from the original award, there may be a delay of a day or so before Canvas Credentials is able to connect and re-bake the badge with the updated information.

If you have updated and replaced a badge using the data management tool, but the image doesn't match the new badge image, please try the following:

  • Wait one to three days. Sometimes, it can take a few days for the badge to resync with Canvas Credentials.
  • Refresh your browser. If Canvas Credentials has already resynced your badge, then the new image may appear after refreshing.
  • If you've tried the above steps and the old image is still showing, you can contact support for assistance at support@badgr.com