# Contests
Source: https://docs.aden.space/docs/help/promote-grow/contests

Gamified fan giveaways where entrants earn points by completing actions (follow on Spotify, save a track, share a link, etc.): with a weighted random draw to pick winners at the end.
{/* Generated by `bun docs:publish` from docs/features/contests.md: edit the spec, not this file. */}

## What it is [#what-it-is]

Contests let an artist or team run a fan giveaway directly from Aden. Fans visit
a public entry page, complete a set of actions (follow the artist on Spotify,
save the new album, follow on Instagram, share a link, and so on), and earn
entries into a draw. The more actions a fan completes, the more chances they
have to win.

Each contest is self-contained: you define the prize, the start and end dates,
the track or album it promotes (its cover fronts the public page), and the ways
fans can enter. When the contest closes you can draw winners at the click of a
button.

## Using it [#using-it]

### Creating a contest [#creating-a-contest]

1. Go to **Contests** in your team sidebar and click **New contest**.
2. Give it a title. The public link is derived from it, e.g.
   `aden.space/contest/your-team/summer-giveaway`.
3. Describe the prize under **Prize**. Markdown is supported.
4. Optionally pick the track or album it promotes, and set start and end dates.
5. **Publish** opens it to fans right away. **Save draft** keeps it private.

### Adding entry actions [#adding-entry-actions]

**Ways to enter** is the same switch checklist download gates use under
"Unlock with" (`components/gates/gate-switch-row.tsx`): one row per action
type, toggled on to add it. Each way is one thing a fan can do to earn points:

* Toggle a way on (Spotify follow, Instagram follow, newsletter sign-up, share
  link, visit URL) and add the link fans are sent to where one is needed.
* Set the **points** value. Fans earn this many entries per completion.
* Mark an action as **Required** if fans must complete it before they can
  enter at all.
* Mark an action as **Repeatable** if a fan can earn points more than once
  (e.g. share once per day). Set a **daily cap** if you want to limit how many
  times per day they can do it.

Ways are shown on the public page in the order you switched them on.

### Sharing the entry page [#sharing-the-entry-page]

Once the contest is active, copy the public URL and share it anywhere. Social
posts, bio links, email newsletters. Fans don't need an Aden account; they just
need an email address.

### Drawing winners [#drawing-winners]

When the contest ends (or at any time while it's active):

1. Open the contest and click **Draw winners**.
2. Enter how many winners you want (limited by the **Max winners** setting you
   configured).
3. Aden runs a weighted random draw. Fans with more points get proportionally
   more chances.
4. Winners are marked in the entries list. The contest status flips to **Ended**.