Raffle for WooCommerce

Get this pluginFree

Settings

Plugin Settings

Complete reference for all Raffle for WooCommerce settings.

Accessing settings

Navigate to: WooCommerce → Settings → Raffle

Settings are organized into six sections: General, Tickets, Display, Compliance, Print Ticket, and Emails.

General settings

Enable gift purchase

Description: Allow customers to buy raffle tickets as gifts for others.

When enabled globally, all new raffle products will have gift purchasing available. Individual products can override this setting.

Generate tickets on

Options:

Payment Complete: Generate when payment is received
Order Processing: Generate when order moves to "Processing" status
Order Completed: Generate when order is marked "Completed"

Default: Order Completed

Recommendation: Use "Payment Complete" or "Order Processing" for digital-only raffles. Use "Order Completed" if you need manual review.

Auto-close sold out

Description: Automatically end a raffle when all tickets are sold.

Default: Yes

When enabled, raffles with a maximum ticket limit will automatically close once the last ticket is purchased.

Default selection method

Options:

Standard Random: WordPress random function
Cryptographically Secure: PHP's random_int()
Random.org: True random from atmospheric noise (requires API key)

Recommendation: Cryptographically Secure for most use cases. Random.org for high-profile or public draws.

Random.org API key

Description: API key for provably fair random selection

How to get:

Visit api.random.org
Create free account
Generate API key
Paste in this field

Free tier: 1,000 requests/day (sufficient for most users)

Tickets settings

Ticket number format

Options:

Sequential: Numbers like 0001, 0002, 0003
Random: Alphanumeric codes like A7X9B2

Recommendation: Sequential for traditional feel, Random for preventing guessing.

Ticket number prefix

Description: Text prepended to all ticket numbers

Examples:

Empty: 0001
"RAFFLE-": RAFFLE-0001
"2024-": 2024-0001

Tip: Keep it short (3-6 characters) for readability.

Starting ticket number

Description: First ticket number for sequential format

Default: 1

Use case: Starting from 1001 for "bigger" looking numbers.

Ticket number padding

Description: Minimum number of digits for sequential ticket numbers.

Default: 4 (e.g., 0001)

Display settings

Show countdown

Description: Display countdown timer on raffle product pages.

Default: Yes

Show countdown on shop pages

Description: Display a compact countdown badge on shop and archive pages.

Default: No

When enabled, a small countdown badge appears on raffle product cards in shop/category pages.

Show progress bar

Description: Display ticket sales progress bar on product pages.

Default: Yes

Only visible when a maximum ticket limit is set.

Show participants count

Description: Display the number of participants on the product page.

Default: Yes

Show tickets sold

Description: Display the number of tickets sold on the product page.

Default: Yes

Show prize value

Description: Display the prize value on the product page.

Default: Yes

Compliance settings

These settings control the skill-testing question and free entry features. See Compliance & Privacy for detailed documentation.

Enable skill-testing question

Description: Require customers to answer a skill-testing question before adding a ticket to cart.

Default: No

When enabled, a random question from the pool is shown on each page load.

Skill-testing question pool

Description: A repeater field to manage the pool of questions.

Each question includes:

Question text
Type: Text input or Multiple Choice
Correct answer
Choices (for Multiple Choice, one per line)

Click "+ Add Question" to add more. Click "Remove" to delete a question.

Enable free entry route

Description: Show a "Free Entry" tab on the product page with alternative entry instructions.

Default: No

Free entry instructions

Description: Default text shown in the Free Entry tab.

Supports the [Your Address] placeholder, which is automatically replaced with your WooCommerce store address (from WooCommerce → Settings → General).

Print ticket settings

Primary color

Description: Primary accent color used on PDF tickets.

Default: #7c3aed (Purple)

Footer text

Description: Custom text displayed at the bottom of PDF tickets.

Badge text

Description: Text displayed on the ticket badge area.

Email settings

Email toggles

The Emails section provides quick toggles for all raffle-related emails:

Setting	Email	Default
Ticket Confirmation	Sent to purchaser when tickets are generated	Enabled
Gift Notification	Sent to gift recipient when tickets are generated	Enabled
Winner Notification	Sent to winner when selected	Enabled
Admin Winner Alert	Sent to admin when a winner is drawn	Enabled
Admin Draw Failed	Sent to admin if an automatic draw fails	Enabled
Prize Claimed	Sent when a winner claims their prize	Enabled

Scroll to see all columns →

Customizing emails

For full email customization, go to WooCommerce → Settings → Emails and find the raffle-specific emails:

For each email:

Enable/Disable: Turn email on/off
Subject: Email subject line
Heading: Email heading text
Additional Content: Custom message

Per-product settings

These settings are configured on each raffle product in the Raffle Settings tab.

Date & time

Setting	Description
Start Date	When ticket sales begin
Start Time	Time sales begin (HH:MM)
End Date	When ticket sales end
End Time	Time sales end (HH:MM)

Scroll to see all columns →

Notes:

Leave start date empty to start immediately
Leave end date empty for no expiration
Uses site timezone

Ticket limits

Setting	Description
Maximum Tickets	Total tickets available
Max Per Customer	Limit per customer email

Scroll to see all columns →

Notes:

Empty = unlimited
Per customer limit applies across all orders
Gift tickets are exempt from per-customer limits

Features

Setting	Description
Allow Gift Purchases	Override global gift setting (Use global / Yes / No)
Auto Draw	Automatically select winners at end

Scroll to see all columns →

Winner settings

Setting	Description
Number of Winners	How many winners to draw (1-10)

Scroll to see all columns →

Prize configuration

Setting	Description
Prize Type	Custom, Product, or Store Credit
Prize Description	Text description of prize
Prize Value	Display value (for Custom type)
Prize Product(s)	WooCommerce products (for Product type)

Scroll to see all columns →

Compliance overrides

Setting	Options	Description
Skill-Testing Question	Use global / Yes / No	Override global skill question toggle
Question Source	Global pool / Custom	Use global pool or custom product question
Custom Question	Text	Product-specific question (when source is Custom)
Question Type	Text / Multiple Choice	Answer input type
Correct Answer	Text	The correct answer
Choices	Textarea	MC options, one per line
Free Entry Route	Use global / Yes / No	Override global free entry toggle
Free Entry Text	Textarea	Custom free entry instructions

Scroll to see all columns →

Default values

If not explicitly set:

Setting	Default
Ticket Format	Sequential
Prefix	Empty
Starting Number	1
Max Tickets	Unlimited
Max Per Customer	Unlimited
Gift Purchases	Disabled
Auto Draw	Disabled
Number of Winners	1
Prize Type	Custom
Generate Tickets On	Order Completed
Auto-Close Sold Out	Yes
Skill-Testing Question	Disabled
Free Entry	Disabled

Scroll to see all columns →

Setting recommendations

For charity raffles

Ticket Format: Sequential
Prefix: "CHARITY-"
Max Per Customer: 20
Gift Purchases: Enabled
Prize Type: Custom
Number of Winners: 3

For Canadian compliance

Skill-Testing Question: Enabled
Free Entry Route: Enabled
Question Pool: 3-5 math questions
Free Entry Text: Mail-in instructions with [Your Address]

For store promotions

Ticket Format: Random
Prefix: Empty
Max Tickets: 500
Max Per Customer: 5
Gift Purchases: Disabled
Prize Type: Product
Auto Draw: Enabled

For high-stakes draws

Ticket Format: Sequential
Random.org API: Configured
Max Tickets: Limited
Max Per Customer: 1
Gift Purchases: Disabled
Prize Type: Custom (document externally)

Settings migration

When updating the plugin:

All settings are preserved
New settings get default values
Check release notes for new options

Troubleshooting settings

Settings not saving

Check user permissions (manage_woocommerce required)
Clear browser cache
Check for JavaScript errors
Disable conflicting plugins

Settings not applying

Clear WooCommerce transients
Refresh product page
Check individual product overrides

Random.org not working

Verify API key is correct
Check quota at random.org dashboard
Test with Standard Random method first

Analytics

Compliance & Privacy