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

Optional: compliance setup

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

• Go to WooCommerce → Settings → Raffle → Compliance.
• Enable Skill-Testing Question and add questions to the pool.
• 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:

• 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.
• Compliance & Privacy: Skill questions, free entry, and GDPR.
• Winner Selection: Drawing winners.
• Shortcodes: Embed raffles on any page.

Need help?

• Check our FAQ.
• Visit WordPress.org Support Forum.
• For bug reports or critical issues, visit Themology Support.