Skip to main content

giveaway create

Command Title​

/giveaway create

Description​

This command allows you to easily create and manage giveaway events on your Discord server. Generate excitement and engagement among your members by offering prizes and encouraging participation through a fun and interactive giveaway experience.

Usage​

/giveaway create <name> <cost> <duration> [supply] [winners] [start_date] [description] [chain] [role] [role_reward] [prize_image] [promo_image]

Parameters​

Required Parameters:​

  • <name>: The name of your giveaway event. This should be a catchy and descriptive title that accurately represents the prize being offered (maximum 60 characters).
  • <cost>: The cost of ticket for your giveaway, represented in the form of points. Participants must spend this amount of points to purchase one ticket into the giveaway. Ensure the cost is a positive integer greater than 0.
  • <duration>: The duration of your giveaway event, specified in the number of days it will run. The maximum duration is 90 days from the start time.

Optional Parameters:​

  • [supply]: The total number of tickets available for your giveaway. If omitted, the supply will be unlimited, meaning there is no cap on the number of times users can participate.
  • [winners]: The number of winners to be randomly selected from the pool of participants. By default, there will be one winner, but you can specify more if desired.
  • [start_date]: The starting date for your giveaway event. If omitted, the giveaway will begin immediately. You can specify a future date in the format yyyy-mm-dd.
  • [description]: A detailed description of your giveaway event, providing additional information about the prize, rules, or any other relevant details (maximum 500 characters).
  • [limit]: The maximum number of tickets a user can purchase. Defaults to 1. Set to -1 for unlimited.
  • [chain]: The blockchain network on which the prize will be distributed. Users must have a linked wallet on the selected blockchain. Supported options include:
    • Empty: No blockchain-specific distribution (default)
    • BTC: Distribute the prize in Bitcoin
    • EVM (ETH/BSC/Polygon, etc.): Distribute the prize on an Ethereum Virtual Machine (EVM) compatible chain (ETH, BSC, Polygon)
    • SOL: Distribute the prize on the Solana blockchain
  • [role]: An optional role requirement for participation in the giveaway. Only members with the specified role will be eligible to enter the giveaway.
  • [role_reward]: An optional role to be awarded to the giveaway winner(s) in addition to the prize. This can be used to incentivize participation and promote specific roles within your server.
  • [prize_image]: An optional image representing the prize being offered in the giveaway. This image will be displayed at the top right corner of the giveaway embed.
  • [promo_image]: An optional promotional image for your giveaway event. This image will be displayed at the bottom of the giveaway embed, serving as a visual banner to attract attention.

Examples​

  • Example 1: Set up a simple giveaway with a 10 point ticket fee and a 7-day duration:

    /giveaway create name:Engagerly Premium Giveaway cost:10 duration:7

  • Example 2: Set up a giveaway with unlimited tickets, a 500 point ticket fee, a 30-day duration, 2 winners, a specific start date, a detailed description, and distributes rewards on the BTC blockchain:

    /giveaway create name:Engagerly NFT Giveaway cost:500 duration:30 winners:2 start_date:2024-08-18 description:Own a piece of the future! Join this giveaway for a chance to win a rare and exclusive NFT. chain:BTC

  • Example 3: Set up a giveaway for EVM-based tokens with a 80 point ticket fee, a 14-day duration, requiring a specific role, and awarding an additional role to the winner:

    /giveaway create name:1000 $MATIC Giveaway cost:80 duration:14 chain:EVM (ETH/BSC/Polygon, etc.) role:@EngagerlySupporter role_reward:@EngagerlyWinner

  • Example 4: Set up a giveaway with a 500 point ticket fee, a 2-day duration, 5 winners, a limit of 3 tickets per user, and a start date of 2024/08/18:

    /giveaway create name:Engagerly Premium Giveaway cost:500 duration:2 winners:5 limit:3 start_date:2024-08-18

Notes​

  • Winners are selected randomly at the end of the giveaway period.
  • The giveaway embed will be displayed in #giveaway channel.

FAQs:​

  • Q: How do I enter a giveaway?

    A: To enter the giveaway, click the "Buy Ticket" button below the giveaway message. The ticket price in points will be shown, so make sure you have enough to grab your chance!

  • Q: Can I create multiple giveaways at the same time?

    A: Yes, you can create as many giveaways as you like.

  • Q: Can I edit a giveaway after it has been created?

    A: No, you can't edit a giveaway after it has been created. However, you can cancel the giveaway using the /giveaway end command.

  • Q: Can I delete a giveaway?

    A: Yes, you can cancel it using the /giveaway end command.