Themology
HomeProductsBlogAboutAccount
Raffle for WooCommerce
Introduction
Getting Started
Creating Raffles
Gift Purchases
Ticket Management
Winner Selection
PDF Tickets & QR
Analytics
Settings
Compliance & Privacy
FAQ
All Documentation
DocsRaffle for WooCommerceFaq

Faq

Frequently Asked Questions

General Questions

What is Raffle for WooCommerce?

Raffle for WooCommerce is a free plugin that adds raffle/lottery functionality to your WooCommerce store. Customers can purchase raffle tickets, and you can draw winners randomly.

Is this plugin free?

Yes, Raffle for WooCommerce is 100% free with no premium version or paid add-ons.

Is it legal to run a raffle?

Laws vary by country/state. Generally:

  • Charity raffles are often allowed with registration.
  • Commercial raffles may be restricted.
  • Sweepstakes (no purchase required) have different rules.
Always check your local laws before running a raffle.

Does this work with WooCommerce Blocks?

Yes! The plugin fully supports both:

  • Classic Checkout
  • Block Checkout (WooCommerce Blocks)
Gift purchasing works seamlessly on both.

Setup Questions

How do I create a raffle?

  • Go to Products → Add New
  • Select "Raffle" from Product data dropdown
  • Set price, dates, tickets limits
  • Configure prize
  • Publish
See Creating Raffles for details.

Why can't I see the Raffle product type?

  • Ensure WooCommerce is active.
  • Ensure Raffle for WooCommerce is active.
  • Clear browser cache.
  • Check for plugin conflicts.

How do I set up automatic winner selection?

  • Edit your raffle product.
  • Go to Raffle Settings tab.
  • Check "Automatically select winners when raffle ends".
  • Save product.
Requires working WordPress cron.

Ticket Questions

When are tickets generated?

Tickets are generated when an order status changes to "Completed". This typically happens:

  • Immediately for virtual/downloadable products.
  • After payment confirmation for PayPal, etc.
  • When you manually mark order complete.

Can I manually create tickets?

No, tickets can only be created through purchases. This maintains integrity and audit trail.

What ticket number formats are available?

  • Sequential: 0001, 0002, 0003...
  • Random: A7X9B2, K3M8P1...
Configure in WooCommerce → Settings → Raffle.

Can customers see their tickets?

Yes, in My Account → My Tickets. They can:

  • View all their tickets.
  • Filter by raffle or status.
  • Download PDF tickets.
  • See which tickets won.

Gift Purchase Questions

Can customers buy tickets as gifts?

Yes, if enabled on the raffle product. At checkout, they can mark the purchase as a gift and enter recipient details.

Who wins if a gift ticket is selected?

The recipient wins, not the purchaser. The ticket is in the recipient's name.

Does the recipient need an account?

No, but having an account (with the same email) lets them:

  • See tickets in My Account.
  • Receive notifications.
  • Track their entries.

Winner Selection Questions

How are winners selected?

Three methods available:

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

Can I trust the random selection?

Yes. All methods are properly random. For maximum transparency, use Random.org which provides independent verification.

What if I need to redraw?

In the Winner Selection metabox, you can "Clear & Redraw" to select new winners. The original selection is logged.

Can the same person win multiple times?

Not with the same ticket. If they bought multiple tickets, different tickets could theoretically win different positions.

Prize Questions

What prize types are available?

  • Custom: Any prize you describe manually.
  • Product: Actual WooCommerce products from your store.
  • Store Credit: Credit/coupon for your store.

How does product prize fulfillment work?

When a winner is selected with a Product prize:

  • A $0 order is automatically created.
  • Order is assigned to winner.
  • You ship/fulfill like any order.

What if I don't have a store credit plugin?

The system automatically creates a coupon code instead. The coupon:

  • Is for the prize value.
  • Is one-time use.
  • Expires in 1 year.

Technical Questions

Is the plugin compatible with HPOS?

Yes, Raffle for WooCommerce is fully compatible with High-Performance Order Storage (HPOS).

Does it work with my theme?

The plugin uses standard WooCommerce templates and styling, so it works with most themes. Tested with:

  • Storefront
  • Astra
  • GeneratePress
  • Kadence

Where is data stored?

Custom database tables:

  • wp_rfw_tickets - Ticket records.
  • wp_rfw_winners - Winner records.
  • wp_rfw_log - Audit log.
Plus WooCommerce product meta for settings.

Is data deleted when I deactivate?

Deactivation: Data is preserved. Uninstall (delete): All data is removed.

Troubleshooting

Tickets not generating

  • Check order status is "Completed".
  • Check product type is "Raffle".
  • Check for PHP errors in debug.log.
  • Try completing order manually.

Emails not sending

  • Check WooCommerce → Settings → Emails.
  • Ensure email is enabled.
  • Check spam folder.
  • Test with WooCommerce test email.

Countdown not showing

  • Clear cache (plugin, CDN, browser).
  • Check raffle has end date set.
  • Check theme compatibility.
  • Check for JavaScript errors.

Winner not selected automatically

  • Verify "Auto Draw" is enabled.
  • Check WordPress cron is working.
  • Ensure raffle has ended.
  • Check for errors in debug.log.

Support

Where can I get help?

How do I report a bug?

  • Check FAQ and docs first
  • Search existing forum topics
  • Create new topic with:
- WordPress version. - WooCommerce version. - Plugin version. - Steps to reproduce. - Expected vs actual behavior.

Can I request features?

Yes! Create a topic on the support forum with your feature request. Popular requests are considered for future versions.

Previous
Compliance & Privacy