# Giveaways

> Run fair Discord giveaways with Based: /gwcreate, winners, rerolls, and entry requirements for roles, account age, messages, invites and server tags.

URL: https://www.jalkarna.in/based/docs/giveaways/  
Last updated: 2026-11-16

The giveaways module hosts giveaways with optional entry requirements. It is off by default. Start one with `/gwcreate`, giving a prize and a duration, and optionally the number of winners, the channel and requirements.

## Entry requirements
- **Roles**: require one or more roles, or block members who have certain roles.
- **Account age and membership**: minimum days since the Discord account was created and minimum uninterrupted days in your server. Both are checked when a member enters and again when winners are drawn.
- **Messages and invites**: a minimum number of messages sent or invites made over a period such as the last 7 days. These need the [activity tracking](https://www.jalkarna.in/based/docs/activity-tracking/) module with message or invite counting on.
- **Server tag**: require members to display your server's tag.

## Picking winners
When a giveaway ends, Based picks winners at random from eligible entries. `/gwreroll` picks new winners, `/gwend` ends a giveaway early, `/gwcancel` cancels it without winners and `/gwlist` shows what is running. Read [how fair giveaways work](https://www.jalkarna.in/based/learn/how-fair-discord-giveaways-work/) for what makes a draw trustworthy.

## Staff and reminders
Set a **giveaway manager role** for members who run giveaways, a maximum duration (720 hours by default), and an optional reminder channel where Based posts a short reminder about running giveaways.

## Settings
Change these in the [dashboard](https://www.jalkarna.in/based/dashboard/) or with `/setup` in Discord. They apply to one server at a time.

| Setting | Default | What it does |
|---|---|---|
| Enabled | Off | Turn this feature on for this server. |
| Giveaway manager role | Not set | Optional. Members with this role can run and manage giveaways. |
| Allowed channels | Not set | Leave empty to let Based work in every channel it can see. |
| Default winners | 1 | How many random winners a giveaway picks unless the host chooses. |
| Maximum duration | 720 | The longest a giveaway can run, in hours. |
| Default entry role | Not set | Optional. Members need this role to enter. |
| Required entry roles | Not set | Members must have every selected role to enter. |
| Blocked entry roles | Not set | Members with any selected role cannot enter. |
| Require server tag | Off | Members must display this server's primary guild tag. |
| Minimum account age (days) | 0 | Minimum age of a Discord account at entry and draw time. |
| Minimum membership (days) | 0 | Minimum uninterrupted time in this server at entry and draw time. |
| Default message requirement | 0 | Messages a member must have sent to enter. Above 0 needs Activity tracking with Count messages on. |
| Default invite requirement | 0 | Invites a member must have made to enter. Above 0 needs Activity tracking with Count invites on. |
| Activity period | 7 days | The time period those message and invite counts cover. |
| Reminder channel | Not set | Optional. Based posts a short reminder about running giveaways here, removing its previous one. |
| Reminder every (hours) | 0 | How often to post the reminder. 0 turns reminders off. |

## Permissions Based needs
For this module Based's role needs: **View Channel**, **Send Messages**, **Embed Links**. See [permissions](https://www.jalkarna.in/based/docs/permissions/) for how to grant them only where they are needed.

## Commands
Every command works as a slash command and with the text prefix (default `.`), so `/gwcreate` and `.gwcreate` do the same thing.

### /gwcreate
Host a giveaway with eligibility requirements.

- Usage: `/gwcreate <prize> <duration> [winners] [channel] [req_messages] [req_messages_window] [req_invites] [req_invites_window] [req_role] [required_roles] [blocked_roles] [require_tag] [account_days] [member_days]`
- `prize` (required): Giveaway prize
- `duration` (required): Giveaway duration, such as 10m, 2h, or 1d
- `winners`: Number of winners; omit to use the server's configured default
- `channel`: Channel for the giveaway
- `req_messages`: Required messages to enter
- `req_messages_window`: Timeframe for required messages
- `req_invites`: Required invites to enter
- `req_invites_window`: Timeframe for required invites
- `req_role`: Required role to enter
- `required_roles`: Required role IDs or mentions, or none to clear defaults
- `blocked_roles`: Blocked role IDs or mentions, or none to clear defaults
- `require_tag`: Require this server's displayed tag
- `account_days`: Minimum account age in days
- `member_days`: Minimum time in this server in days
- Who can use it: Members with Manage Server, in servers only

### /gwend
End an active giveaway.

- Usage: `/gwend [message_id]`
- `message_id`: Giveaway message ID
- Who can use it: Members with Manage Server, in servers only

### /gwreroll
Reroll a giveaway's winners.

- Usage: `/gwreroll <message_id> [winners]`
- `message_id` (required): Giveaway message ID
- `winners`: Number of winners
- Who can use it: Members with Manage Server, in servers only

### /gwlist
List active giveaways for this server.

- Usage: `/gwlist`
- Who can use it: Anyone who can use the command, in servers only

### /gwcancel
Cancel a giveaway without selecting winners.

- Usage: `/gwcancel <message_id>`
- `message_id` (required): Giveaway message ID
- Who can use it: Members with Manage Server, in servers only


## FAQ

### Can I require invites to enter a Discord giveaway?

Yes. Set req_invites on /gwcreate or a default invite requirement. Turn on activity tracking with invite counting first, which needs Manage Server.

### How are winners chosen?

Randomly from members whose entries are still eligible at draw time. Account age and membership requirements are re-checked when the draw happens.
