Documentation menu

Giveaways

Giveaways let you run prize draws with entry requirements, weighted entries, and wallet collection, either from the dashboard or with text commands.

Create a giveaway in the dashboard

Open Dashboard > Giveaways and click New giveaway.

Setting Description
Prize What winners receive. Shown as the title of the post.
Description Optional details shown in the post
Winners 1 to 100
Start time When the giveaway is posted and entries open. Leave empty to start immediately.
End time When entries close and the draw runs, at most 30 days after the start
Channel Where the giveaway is posted
Mention Optional: @everyone, @here, or a role, mentioned when the giveaway is posted
Required role Optional: only members with this role can enter, for example your holder role
Bonus entries by role Optional: up to 10 roles with 2 to 100 entries each, for example @Whale gets 5 entries
Highest weight only When on, a member with several bonus roles gets the entries of their highest one. When off, bonus entries add up.
NFT-weighted entries Optional: instead of a required role and role bonuses, members get one entry per NFT they hold in a collection

Entering

Members click Enter on the giveaway post. NXT checks the requirements and, if the member has more than one proven wallet, asks which one should receive the prize. Members without a proven wallet are offered Verify now. Before the giveaway ends, entrants can Update wallet or Delete entry.

The draw

When the end time arrives:

  1. NXT re-checks every selected winner: they must still be in the server, still meet the required role, still hold their bonus role, and for NFT-weighted giveaways still hold the NFTs.
  2. Winners who no longer qualify are disqualified and replaced automatically from the remaining entries. If a winner's entries dropped, their odds are adjusted to the lower count.

If holdings cannot be read during the draw, nobody is disqualified for it, and NXT retries the draw five minutes later. 3. The draw is weighted random: each entry is a ticket, so a member with 5 entries is five times as likely to win as a member with 1. 4. Winners are announced in a reply to the giveaway post, and the post is updated.

After the draw

From the giveaway in the dashboard you can:

  • Redraw every winner
  • Replace selected winners, for example if they did not claim
  • Export CSV of entries or winners with their Discord names, entries, and the wallets they chose

Text commands

Members with Manage Server can run giveaways directly from a channel:

Command What it does
!gcreate <duration> <winners> "<prize>" Starts a giveaway in the current channel. Duration looks like 30m, 12h, or 3d, up to 30 days. Winners is 1 to 100.
!gdraw <messageId> Ends the giveaway with that post's message ID and draws now
!gredraw <messageId> [@user] Redraws all winners, or replaces only the winners you mention

Example:

!gcreate 2d 3 "Three allowlist spots"

To find a message ID, enable Developer Mode in Discord settings, then right-click the giveaway post and choose Copy Message ID.

Blocked tokens do not count toward NFT-weighted entries.

Something unclear or out of date? Tell us at support@nxtnft.app.