# Contest You can add contest functionality to any of your ReferralHero campaigns. This allows you to: * Reward top advocates * Select random winners (see section: Select Random Contest Winners) * Issue manual rewards for any reason These functionalities are available depending on the template you've selected for the campaign.\ If you're using the Waitlist & Contest template, all contest features are enabled by default. For Affiliate Program, Referral Program, or Custom templates, you'll need to toggle Manual Rewards ON in the Rewards section to use these features.

Feature	Affiliate, Referral Program or Custom	Waitlist & Contest
Reward top advocates	Available when Manual Rewards is toggled ON	ON by default
Select random winners	Available when Manual Rewards is toggled ON	ON by default
Issue manual rewards	Available when Manual Rewards is toggled ON	ON by default

## Manual Rewards for Promoted Winners A manual reward can be triggered when you promote a subscriber through the ReferralHero dashboard or API. To set up a manual reward: 1. Go to Edit Campaign > Rewards > Toggle ON Manual Rewards > Click Add Reward

2. Assign a name (this field is required — leaving it blank will result in a “can’t be blank” error), label, and description to the reward 3. You have the option to set the subscriber’s rank to the last position after promotion **Example:** If you run a weekly competition where the top 5 subscribers on the leaderboard win a reward, and you've enabled the setting to move promoted subscribers to the last position: * Promote the top 5 winners using the dashboard or API * Their ranks are automatically moved to the last positions * In the second week, a new set of top 5 winners can be selected * The previous winners no longer occupy top spots but can still refer others, earn points, and unlock milestone rewards This feature helps maintain fairness and ongoing engagement — without needing to delete past winners from the campaign.

## Promoted Reward Email Notification 1. Turn on the ‘Notify subscriber when this reward is sent’ toggle in the reward setup to send an email notification to the subscribers

2. Go to Edit Campaign > Automations > Reward Emails/SMS Messages 3. Locate the email/SMS for this particular reward 4. Customize the email/SMS 5. Toggle ON the email/SMS and save the changes

## Select Random Contest Winners ReferralHero utilizes the ‘Pickup’ Ruby Gem to choose winners for your contest campaigns. This Gem enables the selection of a winner from the subscriber list with different probabilities based on the number of points/referrals assigned to them. Subscribers with higher point/referral values have a higher chance of being chosen. {% hint style="success" %} **NOTE:** In 'Conversion Events' campaigns, the probability of winning is based on referrals. In 'Conversion Events and Social Share Actions' campaigns, the probability of winning is based on points. {% endhint %} **Example:** > 1\. SubA - 3 points (The chance of SubA to pick is 30% (3/10 \* 100))\ > 2\. SubB - 4 points (The chance of SubB to pick is 40% (5/10 \* 100))\ > 3\. SubC - 2 points (The chance of SubC to pick is 20% (2/10 \* 100))\ > 4\. SubD - 1 point (The chance of SubD to pick is 10% (1/10 \* 100)) > > They make a collection like,\ > \[SubA, SubA, SubA, SubB, SubB, SubB, SubB, SubC, SubC, SubD] The collection is a list that contains four different subscribers (SubA, SubB, SubC, and SubD), each with a different number of points they’ve accumulated. The percentages provided for each subscriber represent the probability of that subscriber being chosen at random from the list. SubA has a 30% chance of being chosen because it has three points, which is 30% of the total points (10) in the list. Similarly, SubB has a 40% chance of being chosen because it has four points, which is 40% of the total points in the list. ## Promote Subscribers There are three ways to promote subscribers: {% hint style="success" %} **NOTE:** * Only subscribers in a Contest or contest-feature enabled campaign with at least one manual reward created can be promoted. * If you have multiple manual rewards set up, it's possible for a subscriber to be promoted multiple times, potentially winning different rewards on separate occasions. {% endhint %} ### Method 1: Pick Winners Randomly 1. In the Subscribers list, check the box next to the subscribers who are qualified for the promoted reward. This will activate the “**Pick Winner**” button

2. Click the **“Pick Winner”** button to open a modal popup with a randomly selected winner

3. To choose a different winner, click the **“Pick new winner”** button to generate a new random selection 4. From the reward dropdown, select the reward you want to assign to the promoted winner 5. Click the **Promote** button to apply the reward ### Method 2: Bulk Promote a Set of Subscribers 1. In the Subscribers list, check the boxes next to the subscribers who are qualified for the promoted reward. This will activate the **“Promote”** button

2. Click the **“Promote”** button to open the **“Reward for Winners”** popup

3. Select the reward you want to assign to the selected subscribers 4. Click **“Promote”** ### Method 3: Promote a Specific Subscriber 1. Go to the subscriber's profile 2. In the **Campaign Info** section, click the three-dot dropdown 3. Select **“Promote”**

4. In the **“Reward for Winners”** popup, select the reward 5. Click **“Promote”** ### Unpromote Option 1. Once a subscriber is promoted, an **“Unpromote”** option will appear in the three-dot dropdown of the **Campaign Info** section within their profile

2. Unpromoting a subscriber will remove them from the Promoted list and place them back into their original position on the Subscribers list. {% hint style="warning" %} **NOTE:** You won’t be able to cancel the rewards that were sent to subscribers when they were promoted. {% endhint %} ## Promoted Subscribers List To view the list of promoted subscribers, select “Promoted” under the Group filter.

All promotions / unpromotions will be recorded in the subscriber’s Timeline Log.

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://support.referralhero.com/campaign-builder/templates/contest.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.