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

• Go to Plugins → Add New in your WordPress admin.
• Search for "Raffle for WooCommerce".
• Click Install Now, then Activate.

Manual Installation

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

Initial Setup

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

Basic Settings

Setting	Description	Recommended
Ticket Number Format	Sequential (0001, 0002) or Random (A7X9B2)	Sequential
Ticket Prefix	Optional prefix for ticket numbers (e.g., "RFL-")	Leave empty or short prefix
Starting Number	First ticket number	1

Optional: Random.org Integration

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

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

Creating Your First Raffle

• Go to Products → Add New.
• In the Product data dropdown, select Raffle.
• Fill in the product details:

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

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

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

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

• Click Publish.

What's Next?

• Creating Raffles - Detailed raffle setup guide.
• Gift Purchases - How gift purchasing works.
• Winner Selection - Drawing winners.

Need Help?

• Check our FAQ.
• Visit WordPress.org Support Forum.