Raffle for WooCommerce

Settings

Plugin Settings

Complete reference for all Raffle for WooCommerce settings.

Accessing Settings

Navigate to: WooCommerce → Settings → Raffle

General 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

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)

Per-Product Settings

These settings are configured on each raffle product.

Raffle Settings Tab

Located in: Product Data → Raffle Settings

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)

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

Notes:

Empty = unlimited
Per customer limit applies across all orders

Features

Setting	Description
Allow Gift Purchases	Enable gifting checkbox at checkout
Auto Draw	Automatically select winners at end

Winner Settings

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

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)

Email Settings

Navigate to: WooCommerce → Settings → Emails

Raffle Emails

Email	Trigger
Ticket Confirmation	Order completed with raffle items
Gift Recipient	Gift purchase notification to recipient
Winner Notification	When winner is selected

Customization Options

For each email:

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

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

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 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