# Gamification

> Run a points game in your event app, with QR scavenger hunts, points for posting, bonus games and a leaderboard.

Source: https://help.highbar.ai/docs/run-your-event/community/gamification
Audience: event organizers, working in the Highbar dashboard

Gamification turns your event into a game. Attendees earn points for scanning QR codes at booths, sessions and speakers, for exchanging contacts, and for being active in the feed, and climb a leaderboard. You decide what scores, how much, and what the winners get.

Open **Community** > **Gamification**. Turn it on from the [Community overview](https://help.highbar.ai/docs/run-your-event/community) first. That sets up a game called "Scavenger Hunt", which you then configure here. Turning gamification off later hides the game and leaderboard from attendees and removes its configuration: activities, point values and bonus games.

## Name the game

Under **Basics**:

- **Label**: the game's name in the app menu, up to 30 characters, such as "Scavenger Hunt" or "Event Game". A new game starts as "Scavenger Hunt". The game's menu entry appears in the [App menu](https://help.highbar.ai/docs/event-app/app-menu) once gamification is on, and renaming it there changes it here too.
- **Icon**: its icon in the menu.
- **Show leaderboard in the app**: with it off, attendees still see their own score, rules, prizes and bonuses, but not the ranking.
- **Leaderboard displays**: **Everyone, top ranks highlighted**, **Everyone, ranked equally** or **Top scorers only**. Then choose how many under **Highlight** (or **Top scorers**): **Top 3**, **Top 5**, **Top 10** or **Custom**.

![The Gamification page with Players, Scans, Points awarded and Top score at 0 and a View leaderboard link. The Basics card has the Label Event game, the Trophy icon selected under Recommended, Show leaderboard in the app on, Leaderboard displays set to Everyone, top ranks highlighted, and Highlight set to Top 3. The App preview shows Event game with Your score 0 pts and How to Play and Prizes buttons.](https://help.highbar.ai/images/community/gamification-basics.webp)

### Rules and prizes

Further down **Basics**, turn on **Show a description of the rules** and **Show a description of the prizes**, and give each a **Label** and a **Description**. Each label becomes a button next to the attendee's score, such as "How to Play" or "Prizes", and opens your text.

![Show a description of the rules and Show a description of the prizes both on, with the Labels How to Play and Prizes and a Description for each. Arrows point to the How to Play label and to the How to Play sheet it opens in the App preview, showing the rules.](https://help.highbar.ai/images/community/gamification-rules.webp)

![The same rules and prizes settings, with arrows pointing to the Prizes label and to the Prizes sheet it opens in the App preview, listing the prizes for 1st, 2nd and 3rd place.](https://help.highbar.ai/images/community/gamification-prizes-preview.webp)

## Choose what earns points

Under **Activities**, pick the game type:

- **Scavenger Hunt**: attendees scan QR codes.
- **Social Activity**: attendees post, like and comment.
- **Hybrid**: both.

Each type shows only its own activities, as below. Turn each one on and set its points. For **Scan sponsors**, **Scan sessions** and **Scan speakers**, you set the points under **Manage sponsors**, **Manage sessions** or **Manage speakers**.

![The Activities card with Scavenger Hunt selected: Scan sponsors and Scan sessions on, each with a Manage button, Scan speakers off, Lead scans on at 100 points and Contact exchange on at 40 points. Below is Bonus games with Add bonus game.](https://help.highbar.ai/images/community/gamification-activities.webp)

![The Activities card with Social Activity selected: Create a post at 30 points, Like a post at 5 and Comment on a post at 10, all on. Under Bonus games, Booth Explorer is marked Inactive with a warning that the game type no longer tracks Scan sponsors.](https://help.highbar.ai/images/community/gamification-social.webp)

![The Activities card with Hybrid selected, listing every activity: Scan sponsors, Scan sessions and Scan speakers, Lead scans at 100 points, Contact exchange at 40, Create a post at 30, Like a post at 5 and Comment on a post at 10.](https://help.highbar.ai/images/community/gamification-hybrid.webp)

Every activity, and how it's set for a new game:

| Activity | When attendees earn points | Default |
| --- | --- | --- |
| **Scan sponsors** | They scan a sponsor's QR code. | On, 50 points |
| **Scan sessions** | They scan a session's QR code. | On, 30 points |
| **Scan speakers** | They scan a speaker's QR code. | Off, 30 points |
| **Lead scans** | A sponsor scans their badge with [lead retrieval](https://help.highbar.ai/docs/run-your-event/lead-retrieval). | On, 100 points |
| **Contact exchange** | An attendee scans another attendee's QR code and saves the contact. The person who scans earns the points. | On, 40 points |
| **Create a post** | They post in the activity stream. | On, 30 points |
| **Like a post** | They like a post. | On, 5 points |
| **Comment on a post** | They comment on a post. | On, 10 points |

**Lead scans** and **Contact exchange** only score while lead retrieval and contact exchange are turned on.

### Who scans what

Scanning works in two directions, and only one of them needs lead retrieval:

- **Attendees scan your codes.** With **Scan sponsors**, **Scan sessions** or **Scan speakers** on, every attendee in the game can scan the codes you print, using the app's scanner. They don't need lead retrieval.
- **Booth staff scan attendees.** With **Lead scans** on, an attendee earns points when booth staff scan their badge. Only people with [lead retrieval](https://help.highbar.ai/docs/run-your-event/lead-retrieval) access can do this.

To have only sponsors scanning, turn off **Scan sponsors**, **Scan sessions** and **Scan speakers**, keep **Lead scans** on, and don't print any game codes. Keep the game type on **Scavenger Hunt** or **Hybrid**: **Social Activity** doesn't include **Lead scans**.

### Choose who takes part and how many points they're worth

Sponsor, session and speaker scans each have their own settings. Here's how to set them up for sponsors; sessions and speakers work the same way.

<Steps>
<Step>
Under **Activities**, make sure **Scan sponsors** is switched on, then click **Manage sponsors**. The **Sponsor scanning** drawer opens.
</Step>
<Step>
Under **QR codes**, choose how many codes to print:

- **Every sponsor has their own QR code** (the default): print one code per booth. Attendees earn points at every booth they scan, and you can see which sponsors they visited. Below the settings, every sponsor is listed with their points and a button to download their code.

  ![The Sponsor scanning drawer with Every sponsor has their own QR code, Different number of points per sponsor, and Show participant badge on with a target emoji. Sponsors are grouped by category, Platinum and Gold, each ticked with 50 pts, a QR button, and Set all for the category.](https://help.highbar.ai/images/community/gamification-sponsor-scanning.webp)

- **One QR code for all sponsors**: print one code and use it at every booth. Quicker to print, but attendees earn points for the first booth only, and you can't tell which booth they scanned. Every sponsor is worth the same points, all sponsors take part, and the list is replaced by **Show shared code**, which opens the one code to download.

  ![The Sponsor scanning drawer with One QR code for all sponsors selected, a warning that codes already printed for each sponsor will count as one, Same number of points awarded for all sponsors at 50 pts, Show participant badge on, and a panel explaining the single code with a Show shared code button.](https://help.highbar.ai/images/community/gamification-shared-code.webp)
</Step>
<Step>
Under **Points per scan**, choose **Same number of points awarded for all sponsors** and type the points, or **Different number of points per sponsor** to set them sponsor by sponsor. To give a whole category the same points, click **Set all** next to it.
</Step>
<Step>
To help attendees find the booths that are in the game, turn on **Show participant badge** and pick an **Emoji** and an optional **Label**. It appears next to each sponsor in the app's lists, and on their profile.
</Step>
<Step>
Choose who takes part. Everyone is ticked to start with: untick a sponsor to leave them out, or untick a category to leave out all of its sponsors. The QR button at the end of a row downloads that sponsor's code. (With one code for all sponsors, there's no list: skip this step.)
</Step>
<Step>
Click **Save**.
</Step>
</Steps>

For sessions and speakers, click **Manage sessions** or **Manage speakers**. They aren't grouped into categories: they're in one list, with **Select all** and **Clear** at the top.

![The Session scanning drawer with Every session has its own QR code, Different number of points per session, and Show participant badge on with a ticket emoji. Below, Sessions (7) with Select all and Clear, each session ticked with its date and time, 30 pts and a QR button.](https://help.highbar.ai/images/community/gamification-session-scanning.webp)

![The Speaker scanning drawer, opened from Manage speakers with the Hybrid game type, with Every speaker has their own QR code, Different number of points per speaker, Show participant badge off, and Speakers (6) with Select all and Clear, each speaker ticked with 30 pts and a QR button.](https://help.highbar.ai/images/community/gamification-speaker-scanning.webp)

<Callout type="warn">
Decide on **QR codes** before you print. If you switch from one code for all to a code each, the shared code you printed stops working. If you switch the other way, the codes you printed all count as one. Points attendees already earned are kept.
</Callout>

## Add bonus games

Bonus games reward milestones, such as scanning five sponsors.

<Steps>
<Step>
Under **Bonus games**, click **Add bonus game**.

![The Gamification page scrolled to Bonus games, with an arrow pointing to the Add bonus game button, and the QR codes card below.](https://help.highbar.ai/images/community/gamification-add-bonus.webp)
</Step>
<Step>
Choose **Award once** or **Award repeatedly** (each time the requirements are met again).
</Step>
<Step>
Enter the **Bonus name**, **Bonus points** (up to 10,000), an optional **Description** and an **Emoji**. The **Preview** shows how the bonus will look.

![The New bonus game drawer with Award once selected, the Bonus name Booth Explorer, 200 Bonus points, the Description Visit five sponsor booths, a medal emoji, a Preview of the bonus, and Scan sponsors under Requirements.](https://help.highbar.ai/images/community/gamification-new-bonus.webp)
</Step>
<Step>
Under **Requirements**, pick an activity from the menu (it lists only the activities your game type tracks) and type how many **times** attendees must do it. Click **Add requirement** for another, up to 8: attendees must meet all of them. Then click **Save**.

![The Edit bonus game drawer scrolled to Requirements, with the activity menu open showing Scan sponsors, Scan sessions, Scan speakers and Lead scans, Scan sponsors selected, 5 times, and an arrow pointing to the times box above Add requirement.](https://help.highbar.ai/images/community/gamification-bonus-requirements.webp)
</Step>
</Steps>

The bonus is listed under **Bonus games**, marked **Once** or **Repeatable**, with buttons to edit or delete it. In the app, a **Bonuses** card under the attendee's score lists the bonuses.

If you switch to a game type that no longer tracks one of a bonus's requirements (such as **Social Activity** for a bonus that needs **Scan sponsors**), the bonus is marked **Inactive** and attendees can't earn it. Switch the game type back, or edit the bonus's requirements.

## Print the QR codes

Under **QR codes**, style the codes with a **Color**, **Dot style**, **Border** and **Center**, and check them in the **Preview**. Turn on **Embed logos and photos in QR codes** to put each sponsor's logo or speaker's photo in the middle of their code. Then click **Download QR codes**. Download **All codes**, just sponsors, sessions or speakers, or **Pick individual codes**. Each code comes as a PNG and an SVG.

![The Bonus games card listing Booth Explorer, marked Once, with edit and delete buttons, and the QR codes card with a purple color, rounded dots and a round border in the Preview, and an arrow pointing to Download QR codes. The App preview shows a Bonuses card with Booth Explorer under the score.](https://help.highbar.ai/images/community/gamification-bonus-qr.webp)

Put sponsor codes on booths, session codes at room doors or on the first slide, and speaker codes on badges or name cards.

## Follow the game

The top of the page shows **Players** (attendees with at least one point), **Points awarded** and the **Top score**, plus **Scans** for a scavenger hunt, **Social actions** for social activity, or both for a hybrid game. Click **View leaderboard** for the full standings, and click a person to see each action they scored for.

![The top of the Gamification page during the game: 1 player of 1 attendees, 11 Social actions, 50 Points awarded and a Top score of 50 with View leaderboard. The App preview's All attendees list shows the leader in first place with 50 pts.](https://help.highbar.ai/images/community/gamification-stats.webp)

To keep some people out of the game (such as staff), turn on **Restrict gamification** for their tag on the [Access](https://help.highbar.ai/docs/event-app/access) page.

To see how many booth QR codes each sponsor's visitors scanned, see **QR Scans** on [Sponsor performance](https://help.highbar.ai/docs/analytics/sponsor-performance).

## What attendees see

The game appears in the app menu under your **Label**. Attendees see their score and rank, your rules and prizes, the bonuses they've earned, and the leaderboard if it's shown. They scan codes with the app's scanner.

![The attendee app's Event game page, opened from Event game in the menu (arrowed): Your score 50 pts with You're ranked 1 of 1 and You're in the Top 3! Keep your lead., How to Play and Prizes buttons, a Bonuses card with Booth Explorer, and All attendees with the attendee in first place.](https://help.highbar.ai/images/community/app-event-game.webp)

