Using the Badges App
Reward and track learner participation using virtual badges. Keep learners engaged by displaying badges on their video tiles, as well as keeping a tally of results in the leaderboard, which can be exported as a CSV for upload to your learning management system.
![](https://assets.zoom.us/images/en-us/desktop/generic/badges-app.png)
Hosts can create separate badge sessions, such as a session for each class they teach or even a session for each activity. Additionally, different groups of users can also be tracked within a session, making it easier to sort and group participants, such as teams or groups in a classroom.
Note: The emojis used in this app belong to X, Inc and other contributors (Copyright 2020), and are licensed under CC-BY 4.0.
This article covers:
Prerequisites for using the Badges App
- A Zoom account
- Zoom desktop client
- Windows: version 5.12.6 or higher
- macOS: version 5.12.6 or higher
- To display badges on each participant’s video tile, users must have:
- The Badges app open
- Their video enabled during the meeting
- The Mirror my video option disabled
How to install from the Zoom App Marketplace
To install the Badges app:
- Sign in to the Zoom App Marketplace.
- Search for Badges.
- Click Add.
- Review the requested permissions and click Authorize.
Once installed, the app is displayed under the Apps section of the Zoom desktop client.
How to use the Badges App
Start a badge session and assign badges
- Start a meeting as the host.
- In the meeting controls, click Apps
. - Open the Badges app.
- Click Create a New Session.
By default the meeting topic will be used as the Session Name, but this can be changed. - Click Create to start the session.
A new session will be created and, by default, all participants in the meeting are listed below for the host to assign badges, with the search bar available to quickly find specific participants. - (Optional) Next to the name of the session , click the pencil icon
to edit the name of the session. - Under each participant’s name, click the add badge icon
to assign a badge.
Recently used badges are displayed below, with additional options available after clicking the ellipsis icon
. - Click an available emoji to add that badge to that participant.
Once a badge is assigned, the host can click on that badge to adjust the number of that specific badge assigned to this participant. - Click End Session when the session is over.
This will save the current badge assignments for this session.
Create a tag
In addition to creating a new session, tags can also be created, edited, and merged ahead of time through Settings.
- Open the Badges app.
- Click the Settings tab
.
Under the Manage Tags section, all current tags are listed, with the following options next to each:
- Edit icon
: Edit the name of the tag. - Delete icon
: Delete this tag.
- Click Create New Tag.
- Enter a name for this tag and click Create.
This tag will now be available when creating a new session or in an existing tag.
Control badge visibility
When badges are assigned, the host can choose to display each participant’s badges in their video tile. Badges and how many of each are displayed in the bottom right corner of each participant’s video tile, after they have added the Badges app.
- Open the Badges app.
- Click the Settings tab
. - Click the Display Badges to Participants toggle to enable or disable badge visibility.
For each participant to have their badges visible, they must each have the following:
- The Badges app open
- Their video enabled
- The Mirror my video option disabled.
Learn more about changing video settings.
View and share badge leaderboards
- Open the Badges app.
- Click the Leaderboard tab
.
All participants are displayed, with their overall badge count, as well as the count for each badge.
Note: This displays the badge count for all inactive sessions, so any active badge sessions are not reflected in the leaderboard. - (Optional) Use the 2 filters to narrow the leaderboards, either by user sessions or tags or specific badges. Sessions with the same name can be filtered by date and time.
Note: The date filter is only shown when a single session is selected. - (Optional) Click Export as CSV to export the current view of the leaderboards as a CSV file.
- Click Share Results to share the current leaderboard to all meeting participants.
Export badge sessions
The host can also export the current badge assignments, which can be then uploaded to their learning management system.
- Open the Badges app.
- Open a session from the list of recent sessions.
- In the bottom right corner of the panel, click the ellipsis icon
.
Additional options will be displayed. - Click Export as CSV.
The current badge assignments will be exported as a CSV file.
How to uninstall from the App Marketplace
- Log in to the App Marketplace web portal.
- Click Manage and then click Added Apps.
- Next to the Badges app, click Remove.
Data Security
The application uses the zoomapp:inmeeting scope to allow users to open it during Zoom meetings, as well as display virtual badges on users’ video foregrounds. Please refer to the Zoom privacy statement for details on how Zoom collects, uses, and shares personal data.
See the full list of Zoom Apps SDK methods accessed by this app below:
- setVirtualForeground - Displays an image in the foreground of the user’s video to display badges assigned to the user.
- removeVirtualForeground - Removes the image which was set using setVirtualForeground from the foreground of the user’s video.
- getMeetingContext - Returns basic meeting information including the meeting topic and ID.
- getMeetingParticipants - Returns a list of meeting participants including their screen name and participant ID.
- getRunningContext - Returns the context in which the app is launched (inMeeting for example).
- getUserContext - Returns basic information about the meeting participant while in a meeting.
- launchAppInMeeting - Starts a new meeting or joins an existing meeting and launches the app in the meeting.
- onMyMediaChange - Notifies the app when the current user's video settings change, when it’s toggled on or off, and when the audio is muted or unmuted.
- onMyUserContextChange - This event is triggered when the current user’s role changes.
- onParticipantChange - This event is triggered when a user joins or leaves a meeting or when a participant's role changes for that meeting.
- openUrl - Opens a URL in the system browser of a user's device.
- sendAppInvitation - Sends the app to the list of participants in the meeting.
- shareApp - Screenshare current app. Optionally share sound as well.
- onRunningContextChange - Event that triggers when the running context is changed.
- getAppContext - This API returns app context token that contains signed app context data for secure backend validation.