Docs / Claims

Claims

Prize distribution with automatic ticket creation, claim tracking, optional forfeits, expiration, and logging.

Features

Automatic Tickets

When a user claims a prize, a private ticket channel is created for prize delivery.

Prize Inventory

Track unclaimed prizes per user. Users can view their pending prizes anytime.

Claim Logging

All claims are logged to your designated channel with completion status.

Custom Instructions

Set custom instructions that appear in claim tickets for prize delivery.

Optional Forfeits

Let winners give up a claim when the server enables the forfeit button.

Open Claim Expiration

Automatically expire unopened claim tickets after a configured window.

Next-Highest-Bidder Fallback

For auction claims, optionally fall back to the next highest bidder when a winner does not open the claim in time.

Bulk Claims

Premium

Give prizes to everyone with a specific role at once.

Completion Workflow

Mark claims as collected when prizes are delivered. Reopen tickets if needed.

Commands

/claim create

Create a claimable prize.

target User or role to receive the prize (required)
item The prize you're giving (required)
log_channel Output channel for the prize (required)
description Description of the prize
/claim inventory

View a user's unclaimed prizes.

user User to view prizes for (required)
/claim refresh

Resend all claim messages. Does not delete old ones.

channel Output channel for the claims (required)

Claim Workflow

  1. 1

    Prize Created

    Use /claim create or win an auction/giveaway. User receives a DM with a claim button.

  2. 2

    User Claims

    User clicks the "Claim Prize" button. A private ticket channel is created.

  3. 3

    Prize Delivery

    Staff can communicate with the winner in the ticket to deliver the prize.

  4. 4

    Mark Collected

    The prize host, claim staff, or an admin clicks "Collected" after the prize is collected. The claim is logged to your log channel.

Configuration

Use the dashboard for the full claim settings set. Use /settings claiming for the core Discord-side claim defaults:

  • Category Where claim ticket channels are created
  • Log Channel Where completed claims are logged
  • Instructions Custom message shown in claim tickets
  • Disable Claiming Record prizes without creating claim tickets (record-only mode)
  • Forfeit Button Dashboard-only setting, off by default; when enabled, winners can forfeit claimable prizes
  • Open Timeout Dashboard-only setting for how long an unopened claim can wait before expiring
  • Next Bidder Fallback Dashboard-only setting for offering expired auction claims to the next highest bidder

Ticket Actions

Collected

Host, claim staff, or admins mark the prize collected and close the ticket after delivery is confirmed. The claim is logged.

Forfeit

When enabled, the winner can forfeit the prize from the claim message instead of opening a ticket.

Cancel

Cancel the claim without completing it. The prize remains unclaimed.

Reopen

Reopen a closed ticket if more communication is needed.

Ready to get started?

Add Prize Bot to your server.

Add to Discord