> ## Documentation Index
> Fetch the complete documentation index at: https://dub-lemonsqueezy-importer.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Program bounties

> Drive partner engagement by creating performance and submission bounties for your partner program

<Tip>
  This feature is only available on [Business plans and
  above](https://dub.co/pricing/partners).
</Tip>

<Frame>
  <img src="https://assets.dub.co/cms/program-bounties.jpg" alt="Program bounties" />
</Frame>

Bounties on [Dub Partners](https://dub.co/partners) let you reward partners for achieving goals or creating content about your product. This guide walks you through creating bounties, setting requirements, and managing submissions.

To view and manage your bounties, go to your **Partner Program** menu and click on **Bounties** under the *Engagement* section:

<Frame>
  <img src="https://assets.dub.co/cms/bounty-navigation.png" alt="Bounty navigation location" />
</Frame>

## Creating a bounty

Click **Create bounty** (or use the `C` keyboard shortcut) to open the bounty creation panel. From here, select the type of bounty you want to create:

* [Performance bounties](#performance-bounties)
* [Submission bounties](#submission-bounties)
* [Social metrics bounties](#social-metrics)

<Info>
  Whenever you create a new bounty, an email notification will be sent to all
  eligible partners at the scheduled start date of the bounty. Make sure to
  finalize your bounty before creating it.

  <Frame>
    <img src="https://assets.dub.co/cms/bounty-email-notification.png" alt="Bounty email notification" />
  </Frame>
</Info>

## Performance bounties

Performance bounties reward partners for achieving measurable milestones, such as a specific number of leads, conversions, revenue, or commissions. They’re tracked automatically and paid out once completed, with no approval needed.

<Frame>
  <img src="https://mintcdn.com/dub-lemonsqueezy-importer/LPY54n66DePcXWZE/images/dub-partners/bounty-performance.png?fit=max&auto=format&n=LPY54n66DePcXWZE&q=85&s=ab4c38b070af2270663ee7845ec40df6" alt="Create performance bounty" width="2014" height="2130" data-path="images/dub-partners/bounty-performance.png" />
</Frame>

Examples:

* Drive 500 leads and earn an additional \$1,000 bonus
* Generate \$1,000 in revenue and earn an additional \$250 bonus
* Earn \$5,000 in commissions and receive an additional \$500 bonus

| Input                  | Description                                                                                                                                                                           |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Description (optional) | Provide additional bounty details. E.g. "This is a one-time promotional period for you to earn additional commissions on top of what you're already earning with our program"         |
| Start date (optional)  | Bounty start date. Partners will receive an email notification on this date about the bounty. If one is not selected, the bounty will start on the creation date.                     |
| End date (optional)    | Bounty end date. If set, bounty will "expire" after the end date and will no longer be eligible for commission.                                                                       |
| Logic                  | The success criteria are based on: total leads, total conversions, total revenue, or total commissions. [Learn more](/help/article/program-bounties#performance-logic).               |
| Reward                 | The reward amount the partner will receive upon completing the bounty.                                                                                                                |
| Groups                 | [Partner group](/help/article/partner-groups) eligibility. The same bounty can be applied to multiple [partner groups](/help/article/partner-groups) – or all groups in your program. |

### Performance logic

When setting the logic for a performance bounty, you can choose from several options depending on how you want performance to be measured.

<Frame>
  <img src="https://assets.dub.co/cms/performance-logic-3.png" alt="Performance bounty logic" />
</Frame>

**Scope** determines how performance is tracked over a specific period.

* **New** - Tracks only performance generated after the bounty starts. For example, if you set a bounty that rewards partners after 10 leads, each partner must generate 10 new leads after the bounty goes live, regardless of how many leads they had before. For revenue-based bounties, only revenue from customers whose first sale happens after the bounty starts is counted.
* **Lifetime** - Counts performance across the partner’s entire lifetime. For example, if you set a bounty that rewards after 10 leads, any partner who already has at least 10 leads will immediately qualify for the reward.

**Activity** determines which metric is tracked for the bounty. Revenue and commissions require a dollar amount to be set.

* Leads
* Conversions
* Revenue
* Commissions

## Submission bounties

Submission bounties reward partners for completing activities that require review, such as creating social media content, publishing a blog post, or hosting an event. Partners submit proof, and rewards are approved once requirements are met.

<Frame>
  <img src="https://mintcdn.com/dub-lemonsqueezy-importer/LPY54n66DePcXWZE/images/dub-partners/bounty-submission.png?fit=max&auto=format&n=LPY54n66DePcXWZE&q=85&s=8c2d2881c4e2a5b3a514e415991f3a4a" alt="Create submission bounty" width="2014" height="2130" data-path="images/dub-partners/bounty-submission.png" />
</Frame>

Examples:

* Release a YouTube video to drive awareness
* Publish a blog post highlighting your product
* Host an event (in-person or online) promoting your brand

| Input                                                    | Description                                                                                                                                                       |
| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                                                     | The name that will be shown to your partners and internally.                                                                                                      |
| Description (optional)                                   | Provide additional bounty details. E.g. "Make sure to attach up to 3 photos of your event as proof for bounty completion."                                        |
| Start date (optional)                                    | Bounty start date. Partners will receive an email notification on this date about the bounty. If one is not selected, the bounty will start on the creation date. |
| End date (optional)                                      | Bounty end date. If set, bounty will "expire" after the end date and will no longer be eligible for commission.                                                   |
| Allowed submissions                                      | The number of submissions required for a partner to complete the bounty. Partners must submit this many entries to complete it.                                   |
| [Submission window](#submission-window) (optional)       | Set how many days before the end date partners can start submitting entries. An end date is required to enter a submission window.                                |
| [Submission frequency](#submission-frequency) (optional) | Set the time between submissions partners can make.                                                                                                               |
| Criteria                                                 | Set the partner submission requirements.                                                                                                                          |
| Reward                                                   | The reward amount the partner will receive upon completing the bounty.                                                                                            |
| Groups                                                   | Partner group eligibility. The same bounty can be applied to multiple [partner groups](/help/article/partner-groups) – or all groups in your program.             |

### Submission window

This is the number of days before the end date that partners can start submitting entries. **An end date is required to enter a submission window.**

<Frame>
  <img src="https://mintcdn.com/dub-lemonsqueezy-importer/WN4z79SI1MBuWF-7/images/dub-partners/submission-window.png?fit=max&auto=format&n=WN4z79SI1MBuWF-7&q=85&s=49875f2fc1d9f45ea9f8c25f51846db0" alt="Submission window" width="2014" height="1156" data-path="images/dub-partners/submission-window.png" />
</Frame>

### Submission frequency

Set the time between submissions partners can make when `Allowed submissions` is greater than one. Partners must submit the full number of allowed submissions to complete the bounty. You can select from:

* Once a day
* Once a week
* Once a month

**Set `Allowed submissions` to greater than one to set a submission frequency.**

<Frame>
  <img src="https://mintcdn.com/dub-lemonsqueezy-importer/WN4z79SI1MBuWF-7/images/dub-partners/submission-frequency.png?fit=max&auto=format&n=WN4z79SI1MBuWF-7&q=85&s=2a9945888c7f1d262544f2c5c714f6a2" alt="Submission frequency" width="2014" height="938" data-path="images/dub-partners/submission-frequency.png" />
</Frame>

If no submission frequency is set, partners can submit all required entries any time the bounty is open for submissions.

### Submission criteria

Add additional requirements to be able to submit a bounty. This includes:

* **Requiring at least one image**: Helpful when a partner needs to provide proof of completion. Up to four images can be included.
* **Requiring at least one URL**: Helpful when a partner needs to provide a URL as proof of completion. Up to 100 URLs can be provided, and the [allowed domains](#allowed-domains) can be configured.

<Frame>
  <img src="https://mintcdn.com/dub-lemonsqueezy-importer/LPY54n66DePcXWZE/images/dub-partners/bounty-submission-criteria.png?fit=max&auto=format&n=LPY54n66DePcXWZE&q=85&s=7c22cc562ecece5964f130efbfd48281" alt="Submission requirements" width="2014" height="1184" data-path="images/dub-partners/bounty-submission-criteria.png" />
</Frame>

By default, partners claiming a submission bounty are asked to describe how they completed the bounty using a text field.

<Frame>
  <img src="https://mintcdn.com/dub-lemonsqueezy-importer/WN4z79SI1MBuWF-7/images/dub-partners/submission-default.png?fit=max&auto=format&n=WN4z79SI1MBuWF-7&q=85&s=21a963455ad40fbcb867be0a46967719" alt="Submission default" width="2014" height="1352" data-path="images/dub-partners/submission-default.png" />
</Frame>

#### Allowed domains

You can restrict submissions to specific domains by defining an allowed domain list.

<Frame>
  <img src="https://mintcdn.com/dub-lemonsqueezy-importer/qY-9hbAkCf-d3s6C/images/dub-partners/allowed-domains.png?fit=max&auto=format&n=qY-9hbAkCf-d3s6C&q=85&s=18d9ede080776214bf68490d12a31166" alt="Allowed domains" width="2014" height="752" data-path="images/dub-partners/allowed-domains.png" />
</Frame>

This is helpful when submissions must come from specific platforms or websites,
such as approved social networks or owned domains.

<Tip>
  Looking to run bounties for social posts with outcome-based rewards? Check out
  the [social metrics submission type](#social-metrics) instead.
</Tip>

#### Custom reward

For certain submission bounties, you may want to have a custom reward for each submission. Here are some examples:

* Pay a custom reward amount for an arbitrary task (e.g. organizing a meetup/webinar)
* Reward 10% if the partner reaches a goal they set by a specific date (e.g. [#FramerChallenge](https://www.framer.com/challenge/))

<Frame>
  <img src="https://mintcdn.com/dub-lemonsqueezy-importer/LPY54n66DePcXWZE/images/dub-partners/bounty-submission-custom-amount.png?fit=max&auto=format&n=LPY54n66DePcXWZE&q=85&s=56937d000dc5b013dadfb8fb0c9eae5e" alt="Create submission bounty" width="2014" height="1312" data-path="images/dub-partners/bounty-submission-custom-amount.png" />
</Frame>

### Social metrics

<Tip>
  Social metrics bounties are only available on the [Advanced plan and
  above](https://dub.co/pricing/partners).
</Tip>

Social metrics bounties are a type of submission bounty that is best used to reward partners based on the performance of their social posts.

<Frame>
  <img src="https://mintcdn.com/dub-lemonsqueezy-importer/LPY54n66DePcXWZE/images/dub-partners/bounty-social-metrics.png?fit=max&auto=format&n=LPY54n66DePcXWZE&q=85&s=6437f2ee75d7b28d4bff7470cddde62d" alt="Create submission bounty" width="2014" height="2130" data-path="images/dub-partners/bounty-social-metrics.png" />
</Frame>

When submitting these bounties, partners can only provide one link, and it's required to be from a verified social account on their [partner profile](/help/article/partner-profile#website-and-socials).

The post they submit must also be created after the bounty has started. This is to avoid partners submitting older content that already has activity.

<Frame>
  <img src="https://mintcdn.com/dub-lemonsqueezy-importer/LPY54n66DePcXWZE/images/dub-partners/bounty-social-metric-criteria.png?fit=max&auto=format&n=LPY54n66DePcXWZE&q=85&s=0e25a44541cd4a8adddb21ca6ce102dd" alt="Setting social metric submissions criteria" width="2014" height="1312" data-path="images/dub-partners/bounty-social-metric-criteria.png" />
</Frame>

<Tip>
  Similar to submission bounties, you can also set a [submission
  window](#submission-window) and [submission frequency](#submission-frequency)
  for social metrics bounties.
</Tip>

#### Select a social platform and target metric

You can track performance on one social platform per bounty, and can select from:

| YouTube |                   |
| ------- | ----------------- |
| Likes   | Total video likes |
| Views   | Total video views |

| Instagram |                          |
| --------- | ------------------------ |
| Likes     | Total post or reel likes |
| Views     | Total post or reel views |

| TikTok |                  |
| ------ | ---------------- |
| Likes  | Total post likes |
| Views  | Total post views |

| X/Twitter |                  |
| --------- | ---------------- |
| Likes     | Total post likes |
| Views     | Total post views |

| LinkedIn  |                      |
| --------- | -------------------- |
| Reactions | Total post reactions |

#### Add a variable bonus

You can also optionally reward for additional performance beyond the base criteria.

<Frame>
  <img src="https://mintcdn.com/dub-lemonsqueezy-importer/LPY54n66DePcXWZE/images/dub-partners/bounty-social-metric-criteria-variable.png?fit=max&auto=format&n=LPY54n66DePcXWZE&q=85&s=6e2326da2193e9885edc12cbe9e5bdc5" alt="Social metric — variable bonus configuration" width="2014" height="1452" data-path="images/dub-partners/bounty-social-metric-criteria-variable.png" />
</Frame>

In this example, the program is rewarding an additional \$10 per 100 likes on the submitted post, up to 1,000 likes.

## Reviewing bounties

For submission bounties, you must review partner submission entries before [approving](#approving-submissions) or [rejecting](#rejecting-submissions) them. To view a submission, click its row in the submissions table.

<Frame>
  <img src="https://assets.dub.co/cms/bounty-table-01.png" alt="Bounty review table" />
</Frame>

In the submission review, you'll see something similar to the examples below, but your view may differ based on the requirements and criteria you've set for the bounty. Each review includes partner information, submission details, and the proof or social content provided to fulfill the criteria.

<Frame>
  <img src="https://mintcdn.com/dub-lemonsqueezy-importer/LPY54n66DePcXWZE/images/dub-partners/bounty-review-examples.png?fit=max&auto=format&n=LPY54n66DePcXWZE&q=85&s=d178fb3ff8e59f2e2f78b776500e4fc0" alt="Bounty review examples" width="2770" height="2224" data-path="images/dub-partners/bounty-review-examples.png" />
</Frame>

From this view, you can either [approve](#approving-submissions) or [reject](#rejecting-submissions) the submission.

### Approving submissions

Once you approve a bounty submission, a [commission](/help/article/partner-commissions) will be automatically created and due at your next payout. The partner will also receive a notification email:

<Note>
  Bounty commissions are recorded as `custom` commissions, which are **not**
  subject to your program's [payout holding
  period](/help/article/partner-payouts#payout-holding-period). They become
  eligible for payout immediately at the next payout cycle – whether the
  submission is approved via the dashboard or the
  [API](/docs/api-reference/endpoint/approve-a-bounty-submission).
</Note>

<Frame>
  <img src="https://assets.dub.co/cms/bounty-approved-email.png" alt="Bounty approved email" />
</Frame>

<Info>
  If you set your reward to **custom** during the approval process, you'll be
  asked to enter the flat rate amount to reward this partner.
</Info>

### Rejecting submissions

When rejecting a bounty submission, you can also select a reason and provide more details for the rejection. This information will be added to the submission record, and will also be sent in an email to the partner.

<Frame>
  <img src="https://mintcdn.com/dub-lemonsqueezy-importer/WN4z79SI1MBuWF-7/images/dub-partners/reject-bounty-modal.png?fit=max&auto=format&n=WN4z79SI1MBuWF-7&q=85&s=5b709c503ceb87a7e6c39ac304551acb" alt="Bounty rejected modal" width="2014" height="962" data-path="images/dub-partners/reject-bounty-modal.png" />
</Frame>

For the rejection reason, you can select from:

* Invalid proof
* Duplicate submission
* Out of time window
* Did not meet criteria
* Other

When rejected, no commission will be created, and the partner email will look similar to the example below.

<Frame>
  <img src="https://mintcdn.com/dub-lemonsqueezy-importer/WN4z79SI1MBuWF-7/images/dub-partners/reject-bounty-email.png?fit=max&auto=format&n=WN4z79SI1MBuWF-7&q=85&s=20219ee41d3a524faa1033df5ed28431" alt="Bounty rejected email" width="2014" height="1390" data-path="images/dub-partners/reject-bounty-email.png" />
</Frame>
