Themology
Docs Raffle for WooCommerce

Getting Started

Getting Started with Raffle for WooCommerce#

Welcome to Raffle for WooCommerce! This guide will help you set up your first raffle in minutes.

Requirements#

  • WordPress 6.0 or higher
  • WooCommerce 8.0 or higher
  • PHP 7.4 or higher

Installation#

From WordPress.org#

  1. Go to Plugins → Add New in your WordPress admin.
  2. Search for “Raffle for WooCommerce”.
  3. Click Install Now, then Activate.

Manual installation#

  1. Download the plugin ZIP file.
  2. Go to Plugins → Add New → Upload Plugin.
  3. Choose the ZIP file and click Install Now.
  4. Click Activate.

Initial setup#

After activation, you’ll see a welcome notice. Click Go to Settings or navigate to WooCommerce → Settings → Raffle.

Basic settings#

SettingDescriptionRecommended
Ticket Number FormatSequential (0001, 0002), Random (A7X9B2), or Alphabet/Pro (A01, B01)Sequential
Ticket PrefixOptional prefix for ticket numbers (e.g., “RFL-”)Leave empty or short prefix
Starting NumberFirst ticket number1

Optional: compliance setup#

If your jurisdiction requires a skill-testing question or “no purchase necessary” entry:

  1. Go to WooCommerce → Settings → Raffle → Compliance.
  2. Enable Skill-Testing Question and add questions to the pool.
  3. Enable Free Entry Route and set the mail-in instructions.

See Compliance & Privacy for detailed setup.

Optional: Random.org integration#

For provably fair winner selection, you can integrate with Random.org:

  1. Go to Random.org API and get a free API key.
  2. Enter the key in WooCommerce → Settings → Raffle → Random.org API Key.

Creating your first raffle#

  1. Go to Products → Add New.

  2. In the Product data dropdown, select Raffle.

  3. Fill in the product details:

    • Product name: Your raffle name (e.g., “Summer Prize Draw”).
    • Price: Ticket price.
    • Description: Raffle details and rules.

  4. Go to the Raffle Settings tab:

    • Set Start Date and End Date.
    • Set Maximum Tickets (total available) or leave empty for unlimited.
    • Set Max Per Customer to limit purchases per person.
    • Enable Allow Gift Purchases if you want customers to buy tickets for others.

  5. Configure the prize in the Raffle Settings tab:

    • Prize Type: Custom, Product, or Store Credit.
    • Prize Description: What the winner gets.
    • Prize Value: Display value.
    • Number of Winners: How many winners to draw.

  6. Add a Product image (prize photo works great).

  7. Click Publish.

What’s next?#

Need help?#