Title: Raffle for WooCommerce
Author: Themology
Published: January 26, 2026
Last modified: May 17, 2026
---
Search plugins
# Raffle for WooCommerce
By [Themology](https://profiles.wordpress.org/themology/)
[Download](https://downloads.wordpress.org/plugin/raffle-for-woocommerce.1.1.13.zip)
* [Details](https://wordpress.org/plugins/raffle-for-woocommerce/#description)
* [Reviews](https://wordpress.org/plugins/raffle-for-woocommerce/#reviews)
* [Installation](https://wordpress.org/plugins/raffle-for-woocommerce/#installation)
* [Development](https://wordpress.org/plugins/raffle-for-woocommerce/#developers)
[Support](https://wordpress.org/support/plugin/raffle-for-woocommerce/)
## Description
**[Raffle for WooCommerce](https://themology.com/products/raffle-for-woocommerce)**
helps you run raffles and sell tickets through your WooCommerce store. Create unlimited
raffles, generate printable tickets with QR codes, and let customers buy tickets
for someone else. Perfect for charities, clubs, schools, and promotional giveaways.
This plugin is completely free. No feature locks. Everything listed below works
out of the box.
#### Buy Tickets for Someone Else
This is the feature that makes us different. Your customers can purchase raffle
tickets as a gift for friends, family, or colleagues. The recipient gets an email
notification with their ticket details. Their name goes into the draw, not the buyer’s
name.
This works great for:
* Charity supporters buying tickets for elderly relatives who cannot purchase online.
* Club members purchasing tickets for their family.
* Businesses buying raffle entries for employees or clients.
* Anyone who wants to gift a chance to win.
#### All Features Included
Every feature listed below is free. No upgrades needed.
**Raffle Management:**
* Unlimited raffles with no restrictions.
* Unlimited ticket sales per raffle.
* Configurable start and end dates with live countdown timer.
* Progress bar displaying tickets sold vs available.
* Auto-close raffles when all tickets are sold.
* Full WooCommerce integration with all payment gateways.
* Mass refund and selective refund with three methods: standard, payment gateway,
or wallet credit via [TeraWallet](https://wordpress.org/plugins/woo-wallet/).
**Gift Purchases:**
* Gift ticket purchasing with automatic recipient notification.
* Per-ticket gift recipient assignment with name, email, and personal message.
* Works with both WooCommerce Block Checkout and Classic Checkout.
**Winner Selection & Management:**
* Winner selection through manual picks, automatic draws, or Random.org verified
selection.
* Instant Win mode: customers find out if they won immediately after purchase with
probability-based or guaranteed interval selection.
* Unique winner enforcement: prevent the same person from winning multiple prizes
in one draw.
* Extend or relist expired raffles: push the end date or reset for a fresh start
without losing ticket data.
* **Winner management tabs:** All Tickets, Winners, and Claimed for cross-raffle
overview.
* Quick “Mark Claimed” and “Resend Notification” buttons with bulk claim action.
* Prize claimed confirmation email to winners when their prize is marked as claimed.
**Shortcodes:**
* `[raffle_card id="123"]` – Full product card with image, countdown, prize, and
buy button.
* `[raffle_cards]` – Multiple raffle cards in a responsive grid:
- `[raffle_cards ids="123,456,789"]` – Display specific raffles by ID.
- `[raffle_cards category="prizes" limit="4"]` – Display raffles from a product
category.
- `[raffle_cards status="active" limit="6" columns="3"]` – All active raffles
in a 3-column grid.
- `[raffle_cards status="all" orderby="random" limit="8"]` – All raffles in
random order.
* `[raffle_countdown id="123"]` – Live countdown timer (compact or full format).
* `[raffle_progress id="123"]` – Ticket sales progress bar.
* `[raffle_prize id="123"]` – Prize information display.
* `[raffle_status id="123"]` – Status badge (Active / Ended / Winner Selected /
Cancelled / Failed / Coming Soon / Sold Out).
* `[raffle_winners id="123"]` – Winner announcement banner with Gravatar, city,
ticket number, and product link. Attributes: `show_avatar`, `show_city`, `show_ticket`,`
show_date`, `show_link`, `limit`.
* All shortcodes support `id="latest"` and `id="active"` keywords to auto-pick
raffles.
**Tickets & Validation:**
* Printable ticket generation with unique ticket numbers.
* QR code generation for checking tickets at events.
* QR code scanner in admin for live event validation.
* CSV export for all ticket data.
* Ticket search by number, name, or email.
**Email Notifications (6 built-in):**
* **Ticket Confirmation** sent to purchaser after buying tickets.
* **Gift Received** sent to gift recipients with their ticket details.
* **Winner Notification** sent to winners when they are drawn.
* **Prize Claimed Confirmation** sent to winners when their prize is marked as
claimed.
* **Admin Winner Alert** sent to admin when a winner is selected.
* **Admin Draw Failed Alert** sent to admin when an automatic draw fails.
* All emails are configurable in WooCommerce > Settings > Raffle > Emails and in
WooCommerce > Settings > Emails.
**Display Options:**
* Winner announcement banner with Gravatar, city, ticket number, and product link.
* Compact countdown badge on shop and archive pages (optional setting).
* Instant Win ribbon overlay on product images — works on single product, shop,
archive, and anywhere products appear (like the WooCommerce “Sale!” badge). Configurable
position (top-left or top-right).
* Instant Win badge alignment: center, left, right, or full width.
* Instant Win winners display control: always show, only after raffle ends, or
never. Prevents discouraging purchases when all instant prizes are claimed early.
* Urgency color shift when less than 3 days remain.
* Status badges on archive pages: Winner Selected, Ended, Cancelled, and Failed.
* Customizable primary color, badge text, and footer for printable tickets.
**Compliance & Legal:**
* Skill-testing question system with configurable question pool (text and multiple
choice). Global pool questions are pinned per product for consistency.
* Optional time limit for skill questions with live countdown timer.
* Max attempt limit per customer per product to prevent brute-force guessing.
* Multiple choice display options: radio buttons or dropdown select.
* Free entry route with “Paid Entry” / “Free Entry” tab interface for jurisdictions
requiring “no purchase necessary” alternatives. Includes the skill-testing question
so postal entrants know what to answer.
* Per-product compliance overrides to enable or disable skill questions and free
entry on individual raffles.
* Store address auto-replacement in free entry instructions using the `[Your Address]`
placeholder.
**Analytics & Reporting:**
* Analytics dashboard showing sales and performance.
* Activity log tracking ticket generation, winner draws, prize claims, and more.
* Full audit trail for charity compliance and reporting.
* GDPR compliant with personal data export and erasure.
**Checkout & Access Control:**
* Guest access control: allow, block, or force login before raffle purchases.
* Payment gateway restrictions per product — hide specific gateways (e.g., COD,
bank transfer) when a raffle is in the cart.
* Mixed checkout restriction — optionally prevent raffle and non-raffle products
in the same cart.
* Skip cart page — redirect customers directly to checkout after adding a raffle
to cart.
* Ticket number suffix — add text after ticket numbers alongside the existing prefix.
**Technical:**
* Works with WooCommerce High Performance Order Storage (HPOS).
* Works with WooCommerce Block Checkout.
* REST API available for custom integrations.
* Translation ready for any language.
* Addon extensibility layer with hooks and filters for third-party extensions.
#### Who Should Use This Plugin
* Charities and nonprofits running online fundraisers.
* Golf clubs, sports clubs, and social clubs doing member prize draws.
* Schools and parent associations raising funds.
* Churches and community groups organizing raffles.
* Local businesses running customer promotions.
* Online stores creating giveaways and contests.
#### Want More? Take it further with Pro
> **Already running raffles?** Everything above is yours – free, forever, no catches.
> Want to give your customers an interactive, visual experience on top of that? **
> [Raffle for WooCommerce Pro](https://themology.com/products/raffle-for-woocommerce-pro)**
> adds a new layer of engagement:
> * **Pick Your Own Ticket:** Visual ticket grid where customers choose their lucky
> numbers.
> * **Lucky Dip:** One-click random ticket selection from available numbers.
> * **Advanced Instant Win:** Pre-selected winning tickets, multi-tier prizes,
> and prize separation.
> * **Lucky Wheel / Spin to Win:** Interactive wheel animation with configurable
> prizes, standalone wheels, popups, and email gate.
> * **Winner Reveal Page:** Live draw animations with confetti, perfect for live-
> streaming.
> * **Entry / Participant List:** Public participant page with privacy controls.
> * **Alphabet Ticket Format:** Ticket numbers in A01–Z99 format for a traditional
> raffle feel.
> * **Ticket Reservation:** Hold selected tickets for a limited time to prevent
> checkout conflicts.
> * **IP Purchase Restriction:** Limit ticket purchases per IP address to prevent
> multi-account abuse.
> * **Bonus Tickets:** Auto-award extra draw entries based on quantity, early bird
> timing, or customer role.
> * **Reward Points (WooRewards):** Earn and redeem loyalty points on raffle tickets.
> * **Email PDF Ticket:** Auto-attach branded PDF raffle tickets with QR codes
> to order confirmation emails.
> * **Countdown & Badge Styles:** 17 countdown timer styles and 9 instant win badge
> styles with animations, glassmorphism, neumorphism, gradient borders, and more.
> Same raffle system. More ways to engage your customers. [Learn more about Pro](https://themology.com/products/raffle-for-woocommerce-pro).
#### How to Create Your First Raffle
1. Add a new product in WooCommerce.
2. Select Raffle as the product type.
3. Set your ticket price and how many tickets you want to sell.
4. Choose start and end dates for your raffle.
5. Turn on gift purchasing if you want customers to buy for others.
6. Publish your raffle and start selling.
7. When the raffle ends, pick a winner manually or let the system choose automatically.
8. The winner gets an email with prize details.
#### Embed Raffles Anywhere with Shortcodes
Use shortcodes to display raffle information on any page, post, or landing page,
not just WooCommerce product pages.
The `[raffle_card]` shortcode gives you a complete, self-contained raffle preview
with image, countdown, prize, and buy button. Perfect for homepages, blog posts,
and landing pages. Use `[raffle_cards]` to display multiple raffles in a responsive
grid. Filter by IDs, category, or status with customizable columns. Use `[raffle_winners]`
to showcase past winners with their avatar, city, and winning ticket on a dedicated
Winners page.
All shortcodes accept a product ID or use `id="latest"` / `id="active"` to automatically
pick the most relevant running raffle. See the [full documentation](https://themology.com/docs/raffle-for-woocommerce)
for examples.
#### Built for Developers
* Compatible with WooCommerce 8.0 and newer.
* Works with High Performance Order Storage out of the box.
* Block checkout support included.
* REST API available for custom integrations.
* Translation ready for any language.
* Hooks and filters throughout for customization.
#### Get Help
* Read the [documentation](https://themology.com/products/raffle-for-woocommerce)
at Themology.
* Ask questions in the [WordPress.org support forum](https://wordpress.org/support/plugin/raffle-for-woocommerce/).
* Visit [Themology.com](https://themology.com/support) for bug reports or feature
requests.
### External Services
This plugin connects to the following external services to provide certain functionality.
#### QR Server API
The plugin generates QR code images for raffle tickets using the QR Server API.
What gets sent: Only the ticket validation URL that gets encoded into the QR image.
No personal information is transmitted.
When this happens: When a customer views or prints their ticket.
Provider: Foundata GmbH (Germany)
Terms of service: [goqr.me/api/](https://goqr.me/api/)
Privacy policy: [goqr.me/de/rechtliches/datenschutz-qrserver.html](https://goqr.me/de/rechtliches/datenschutz-qrserver.html)
The API is free and does not require registration.
#### Random.org (Optional)
When you select a winner using the Random.org method, the plugin requests random
numbers from their API. This gives you certified random selection for fair draws.
What gets sent: A request for random numbers. No customer data or personal information
leaves your site.
When this happens: Only when you click the button to select a winner using Random.
org. Never automatic.
You can read their terms at [random.org/terms](https://www.random.org/terms/) and
their privacy policy at [random.org/privacy](https://www.random.org/privacy/).
You do not need to use Random.org. Manual and automatic selection work without any
external connections.
## Screenshots
[⌊Plugins Settings⌉⌊Plugins Settings⌉[
Plugins Settings
[⌊Plugins Settings⌉⌊Plugins Settings⌉[
Plugins Settings
[⌊Plugins Settings⌉⌊Plugins Settings⌉[
Plugins Settings
[⌊Plugins Settings⌉⌊Plugins Settings⌉[
Plugins Settings
[⌊Plugins Settings⌉⌊Plugins Settings⌉[
Plugins Settings
[⌊Countdown timer and progress bar on the product page.⌉⌊Countdown timer and progress
bar on the product page.⌉[
Countdown timer and progress bar on the product page.
[⌊Gift ticket purchase option at checkout.⌉⌊Gift ticket purchase option at checkout
.⌉[
Gift ticket purchase option at checkout.
[⌊Admin order details.⌉⌊Admin order details.⌉[
Admin order details.
[⌊Customer ticket list in My Account.⌉⌊Customer ticket list in My Account.⌉[
Customer ticket list in My Account.
[⌊Printable ticket with QR code.⌉⌊Printable ticket with QR code.⌉[
Printable ticket with QR code.
[⌊Admin winner selection screen.⌉⌊Admin winner selection screen.⌉[
Admin winner selection screen.
[⌊Raffle product settings showing dates and ticket limits.⌉⌊Raffle product settings
showing dates and ticket limits.⌉[
Raffle product settings showing dates and ticket limits.
[⌊Ticket management list⌉⌊Ticket management list⌉[
Ticket management list
[⌊QR code scanner for event check in.⌉⌊QR code scanner for event check in.⌉[
QR code scanner for event check in.
[⌊Analytics dashboard with sales data.⌉⌊Analytics dashboard with sales data.⌉[
Analytics dashboard with sales data.
[⌊Prize claimed.⌉⌊Prize claimed.⌉[
Prize claimed.
## Installation
#### Install from WordPress
1. Go to Plugins then Add New in your WordPress admin.
2. Search for Raffle for WooCommerce.
3. Click Install Now and then Activate.
4. Go to WooCommerce then Settings then Raffle to set up your options.
#### Install Manually
1. Download the plugin zip file.
2. Go to Plugins then Add New then Upload Plugin.
3. Upload the zip file and click Activate.
4. Go to WooCommerce then Settings then Raffle to set up your options.
#### What You Need
* WordPress 6.0 or newer.
* WooCommerce 8.0 or newer.
* PHP 7.4 or newer.
## FAQ
### Is this plugin actually free?
Yes. Every feature listed above works without paying anything. No feature locks.
No nag screens. No premium gates. If you need advanced interactive features like
ticket picking grids, lucky wheel, or gamification animations, those are available
in the separate [Raffle for WooCommerce Pro](https://themology.com/products/raffle-for-woocommerce-pro)
addon. But the free plugin is a complete raffle system on its own — most stores
will never need anything more.
### How does gift ticket purchasing work?
When a customer adds raffle tickets to their cart, they can choose to buy them as
a gift. They enter the recipient’s name and email at checkout. The recipient gets
an email saying they received raffle tickets. The recipient’s name appears on the
ticket and enters the draw.
### What winner selection options do I have?
You can pick winners three ways. Manual selection lets you browse all tickets and
choose yourself. Automatic selection picks a random winner when the raffle ends.
Random.org selection uses their certified random number service for verified fair
draws.
### Can I run multiple raffles at the same time?
Yes. Create as many raffles as you need. Each raffle is a separate WooCommerce product
with its own settings.
### How do customers see their tickets?
Customers can view all their raffle tickets in the My Account section. They can
also print tickets with QR codes for each entry.
### Can I check tickets at a live event?
Yes. Use the QR code scanner in your WordPress admin. Scan the QR code on any ticket
to verify it and mark it as checked in.
### Does this work with WooCommerce subscriptions?
This plugin handles one time raffle ticket purchases. You can create new raffles
whenever you want.
### Can I export ticket data?
Yes. Export all tickets to a CSV file from the admin dashboard. Filter by raffle,
date, or status before exporting.
### Is this plugin GDPR compliant?
Yes. The plugin integrates with WordPress privacy tools. Customers can request their
data or ask for deletion. Gift recipient data is only used for ticket delivery and
draw purposes.
### Can I display raffle countdowns or cards on any page?
Yes. The plugin includes seven shortcodes you can use on any page, post, or landing
page. Use `[raffle_card id="123"]` for a full product card with image, countdown,
and buy button, or `[raffle_cards ids="123,456" columns="3"]` to display multiple
raffles in a grid. Use `[raffle_countdown id="123"]` for just the timer, `[raffle_progress
id="123"]` for the progress bar, `[raffle_prize id="123"]` for prize info, `[raffle_status
id="123"]` for a status badge, or `[raffle_winners id="123"]` to display the winner
announcement with avatar, city, and ticket details. You can also use `id="latest"`
or `id="active"` instead of a product ID.
### Can I show countdown timers on the shop page?
Yes. Go to WooCommerce > Settings > Raffle > Display and enable “Show Countdown
on Shop Pages.” This adds a compact countdown badge below the price for raffle products
on shop and category archive pages. Products with less than 3 days remaining show
an urgency-colored badge.
### How do I manage winners across all raffles?
Go to WooCommerce > Raffle Tickets. The page has three tabs: All Tickets, Winners,
and Claimed. The Winners tab shows all winners across all raffles with quick “Mark
Claimed” and “Resend Notification” buttons. You can also bulk-select winners and
mark them as claimed in one click. The per-product Winner Selection metabox on the
product edit page still works for per-raffle management.
### What email notifications does the plugin send?
The plugin includes six email notifications: Ticket Confirmation (to purchaser),
Gift Received (to gift recipient), Winner Notification (to winner), Prize Claimed
Confirmation (to winner when claimed), Admin Winner Alert (to admin), and Admin
Draw Failed Alert (to admin). Each can be toggled on or off in WooCommerce > Settings
> Raffle > Emails, and customized in WooCommerce > Settings > Emails.
### What is Instant Win?
Instant Win lets customers find out if they won immediately after purchasing a ticket,
rather than waiting for the raffle to end. Enable it per raffle product with two
modes: probability-based (e.g., 1 in 50 chance per ticket) or guaranteed interval(
one winner every N tickets). Results appear on the order thank-you page and in the
customer’s My Account ticket list.
### Can I prevent the same person from winning multiple prizes?
Yes. Enable “Unique winners only” on a raffle product. When drawing multiple winners,
the system ensures each person can only win one prize tier. After a ticket holder
wins, all their remaining tickets are excluded from subsequent draws.
### Can I extend or relist an expired raffle?
Yes. On the product edit screen, the Winner Selection metabox shows “Extend” and“
Relist” buttons for completed, failed, or cancelled raffles. Extend pushes the end
date forward while keeping all tickets and winners. Relist resets the raffle to
a fresh state — clears winners and terminal status but preserves existing ticket
data.
### Can I restrict which payment gateways are available for raffles?
Yes. Each raffle product has a “Disabled payment gateways” multi-select field. Select
any gateways you want to hide when that raffle is in the cart. This is useful for
disabling Cash on Delivery or bank transfer for raffle purchases. When Instant Win
is enabled with “require instant payment,” offline gateways are hidden automatically.
### Can I block guest users from buying raffle tickets?
Yes. Go to WooCommerce > Settings > Raffle > General and set Guest Access to “Block”(
shows a login message on the product page) or “Force login” (redirects to the login
page). The default is “Allow” which keeps the current behavior.
### Can I show an “Instant Win” ribbon on product images?
Yes. Go to WooCommerce > Settings > Raffle > Display and enable “Show Instant Win
Ribbon on Images.” This adds an accent-colored ribbon tag on the product image,
similar to the WooCommerce “Sale!” badge. It appears on single product pages, shop
pages, archive pages, and anywhere the product is displayed. You can set the position
to top-left (default) or top-right. The ribbon uses your configured accent color
and only shows on active raffle products with Instant Win enabled.
### Will this work with my theme?
Yes. The plugin uses minimal styling and inherits your theme’s appearance. It works
with any theme that supports WooCommerce.
### Can I customize the printable tickets?
Yes. You can customize the primary color, badge text, and footer message in WooCommerce
Settings under the Raffle > Print Ticket section. Email templates use the standard
WooCommerce email system.
### What happens if a winner does not claim their prize?
You can redraw a new winner from the admin panel. The original winner can be marked
as unclaimed.
### How do skill-testing questions work?
Go to WooCommerce > Settings > Raffle > Compliance and enable Skill-Testing Questions.
Build a question pool with text or multiple choice questions. When enabled, customers
see a randomly selected question on the product page and must answer correctly to
add tickets to the cart. Answers are validated server-side with secure hashing.
You can also override the global setting per product in the product’s Compliance
Settings tab. Optional enhancements include a countdown timer, max attempt limits
per customer, and dropdown display for multiple choice answers.
### How do refunds work for failed or cancelled raffles?
Go to WooCommerce > Raffle Tickets > Mass Refund tab. Select a failed or cancelled
raffle and click “Refund All Tickets”. You can also select individual tickets from
the All Tickets tab and refund just those. Three refund methods are available: Standard
refund (creates WooCommerce refund records for manual processing), Refund via payment
gateway (automatically returns money for Stripe, PayPal, etc., with fallback for
offline gateways), and Refund to wallet (credits the customer’s [TeraWallet](https://wordpress.org/plugins/woo-wallet/)
balance so they can reuse it for future purchases). The wallet option requires the
free TeraWallet plugin to be installed and active.
### What is the free entry route?
The free entry option adds a “Paid Entry” / “Free Entry” tab interface on the raffle
product page. This satisfies “no purchase necessary” requirements in jurisdictions
like Canadian provinces. Enable it in WooCommerce > Settings > Raffle > Compliance
and write your own instructions. Use the `[Your Address]` placeholder to auto-insert
your WooCommerce store address. You can also override this per product.
## Reviews
### [Nice plugin I love it very well, best ever and i appreciate him making it free](https://wordpress.org/support/topic/nice-plugin-i-love-it-very-well-best-ever-and-i-appreciate-him-making-it-free/)
[greenbon](https://profiles.wordpress.org/greenbon/) February 9, 2026 1 reply
Nice plugin I love it very well, best ever and i appreciate him making it free hi
I need a customization for this plugin, how do contact you for a paid job.
[ Read all 1 review ](https://wordpress.org/support/plugin/raffle-for-woocommerce/reviews/)
## Contributors & Developers
“Raffle for WooCommerce” is open source software. The following people have contributed
to this plugin.
Contributors
* [ Themology ](https://profiles.wordpress.org/themology/)
[Translate “Raffle for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/raffle-for-woocommerce)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/raffle-for-woocommerce/),
check out the [SVN repository](https://plugins.svn.wordpress.org/raffle-for-woocommerce/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/raffle-for-woocommerce/)
by [RSS](https://plugins.trac.wordpress.org/log/raffle-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 1.1.13
* Dev: New filter `rfwc_eligible_tickets` exposes the draw pool so addons can combine
tickets across multiple raffles (e.g. a master drawing). Defaults to the existing
per-raffle pool, so no behavior change for stores that do not extend it.
* Dev: New filter `rfwc_should_auto_draw` lets addons suppress the automatic per-
raffle draw for individual raffles, useful when a parent process handles winner
selection across a group of raffles. Defaults to true.
* Dev: New filter `rfwc_admin_tickets_extra_tabs` lets addons append tabs to the
Raffle Tickets admin page. Pair it with the new `rfwc_admin_tickets_render_view`
filter to render custom views without forking the page.
#### 1.1.12
* Fix: Gift recipient email was not sent when every ticket in an order was a gift,
so all-gift orders left buyers with the order confirmation but no gift notification
reaching the recipient. Triggered by a hook timing issue: each raffle email registered
itself on the source action (e.g. `rfwc_gift_tickets_generated`) instead of the
WooCommerce-dispatched `_notification` variant. The first email-related action
of a request loaded `WC_Emails` for the first time, but PHP’s `foreach` over
the priority-10 callback bucket ran on a snapshot taken before our handler registered
itself, so the gift notification was silently skipped. Mixed self plus gift orders
worked because the earlier non-gift action warmed up the registry. Every raffle
email handler now hooks the `_notification` variant that WooCommerce dispatches
after `WC_Emails::instance()`, so the handler is registered before the dispatch
and runs reliably whether emails are sent synchronously or via the deferred background
emailer. Affected: ticket confirmation, gift received, winner notification, admin
winner alert, prize claimed, admin draw failed, admin mass refund summary, and
ticket refunded emails.
* Dev: Renamed the ticket refund action from `rfwc_ticket_refunded_notification`
to `rfwc_ticket_refunded` to match WooCommerce’s email action convention. The`
_notification` suffix is now appended automatically by WooCommerce, so the email
handler listens to the auto-dispatched `rfwc_ticket_refunded_notification` variant.
Custom code that hooked into `rfwc_ticket_refunded_notification` directly should
switch to `rfwc_ticket_refunded` (the auto-dispatched `_notification` variant
remains the email trigger point).
#### 1.1.11
* Fix: Countdown timer values, ticket progress styling, and other raffle UI did
not render when a raffle was embedded on a regular page via the WooCommerce `[
product_page id="X"]` shortcode. Markup loaded correctly but the frontend CSS
and JS never enqueued because the asset gate only checked `is_product()`, which
returns false on a regular page rendered through the shortcode. Asset loading
now also detects raffles embedded via `[product_page]`.
* New: Self-claim option in gift orders. When the new “Allow Self-Claim in Gift
Orders” setting is enabled (WooCommerce > Settings > Raffle > Display), each
recipient field at checkout gets a “This ticket is for me” checkbox. Buyers can
mix tickets they keep with tickets they gift in a single order. Self tickets
stay with the buyer and count against the per-customer max; gift tickets remain
exempt and route to recipients as before. Defaults off so existing stores see
no change. Classic Checkout only — Block Checkout is not yet supported.
* Dev: New helper functions `rfwc_get_current_raffle_ids()` and `rfwc_get_current_raffle(
$check )` for addons and themes that need to identify the raffle product on the
current frontend request, including pages that embed a raffle via `[product_page]`.
#### 1.1.10
* Fix: General product data tab was hidden for Simple, Variable, Grouped, and External
products when the plugin was active. The tab was incorrectly being tagged with
the `show_if_raffle` CSS class, which the plugin’s admin JS then hid for any
non-raffle product type. The General tab is now only force-shown for raffle products
and keeps its default WooCommerce visibility for every other product type.
* Fix: Selecting “Raffle” as the product type briefly stacked the General panel
content (pricing) above the Raffle Settings panel content (dates, tickets) until
another tab was clicked. The admin JS was force-showing `#general_product_data`
alongside the active panel. Pricing fields are still force-shown inside the General
panel via their CSS classes, but the panel itself now follows WooCommerce’s normal
tab-click visibility.
* Fix: Extending or relisting a raffle could accept an end date that wasn’t actually
in the future on sites where the WordPress timezone differs from the server PHP
timezone. The validation now parses the merchant’s input in the site timezone(
via `wp_timezone()`) before comparing against the current UTC time.
* Dev: Documented Terms of Service link for the QR Server API in the External Services
section of the readme. Added a `.distignore` so dev configs (`phpcs.xml`, `phpstan.
neon`, `composer.json`, `tasks.md`, `docs/`, etc.) are excluded from WordPress.
org packages. Added `manage_woocommerce` and related WooCommerce capabilities
to the PHPCS ruleset to silence false-positive “unknown capability” warnings.
#### 1.1.9
* Fix: “Max per customer” left blank or set to 0 was capping non-gift purchases
at 1 ticket instead of unlimited as the field tooltip stated. Empty/0 now correctly
means unlimited per customer (constrained only by total tickets), matching the
documented behavior. Stores that relied on the previous default-to-1 behavior
should set the field to 1 explicitly.
* Fix: “Max per customer” could be saved with a value greater than “Total tickets”.
The save handler now clamps the value to total tickets and shows an admin notice
when this happens.
#### 1.1.8
* Improvement: Automatic draw now schedules a precise cron event at the exact raffle
end time instead of relying solely on the hourly sweep. Reduces draw delays on
sites with low traffic or unreliable WP-Cron.
* Improvement: Product editor now shows a warning when a raffle has Instant Win
enabled but the global Instant Win module is turned off in WooCommerce > Settings
> Raffle.
* Improvement: Added diagnostic logging for auto-draw skip reasons (raffle not
ended, winners exist, terminal status, instant-win-only) to WooCommerce logs
for easier troubleshooting.
#### 1.1.7
* Improvement: Number of winners is no longer limited to 5. You can now configure
up to 20 winners per raffle (filterable via `rfwc_max_prize_tiers` for even higher
limits). Perfect for cash raffles with many winners.
* Added: `rfwc_get_ordinal()` and `rfwc_max_prize_tiers()` helper functions for
consistent tier labeling across free and pro plugins.
#### 1.1.6
* Fix: CSV export for tickets and winners was capped at 200 rows. Exports now return
all matching records with no hard limit. Admin page views retain the 200-row
default for performance.
#### 1.1.5
* Fix: Fatal error on sites using Header Footer Elementor or themes that set the
global $product variable to a non-object value before WooCommerce initializes
it. All frontend template guards now use instanceof checks for full compatibility.
* Fix: Improved responsive layout for countdown timers inside raffle card shortcodes
on small screens.
* Fix: Winner display, prize details, and quantity selector now stack properly
on mobile viewports.
* Improvement: Single raffle card shortcode is now centered by default.
#### 1.1.4
* Improvement: Frontend CSS now uses CSS custom properties for card and element
colors (`--rfwc-card-bg`, `--rfwc-card-text`, `--rfwc-card-text-secondary`, `--
rfwc-card-border`, `--rfwc-button-text`). Defaults match existing values so there
is zero visual change. Pro addon can override these via the new Color Customization
settings.
* Improvement: Updated 20+ selectors across card, countdown, progress, prize, quantity,
and gift toggle elements to use the new color variables instead of hardcoded
hex values.
#### 1.1.3
* New: Filterable prize data in winner notification emails — allows Pro addon to
display instant win-specific prize names and values instead of the main draw
prize
* Dev: Added `rfwc_winner_email_prize_name` and `rfwc_winner_email_prize_value`
filters for customizing prize info in winner emails
#### 1.1.2
Released March 2026.
**New Features:**
* New: Instant Win Winners Display setting. Control when instant win winners appear
on the product page and winners shortcode: “Always show” (default, current behavior),“
Only after raffle ends” (hides winners while the raffle is still active), or “
Never show.” Useful for avoiding customer discouragement when all instant prizes
are claimed before the raffle sells out. Winners still receive their notification
email regardless of this setting. Found in WooCommerce > Settings > Raffle >
Display.
**Bug Fixes:**
* Fix: Block checkout spinning indefinitely after payment with instant win enabled.
The instant win evaluator was creating a separate order object and calling `$
order->save()` for every ticket during the Store API checkout response, causing
timeouts and preventing the redirect to the thank-you page. Now accumulates all
instant win results in memory on the same order instance and saves once after
all tickets are processed.
#### 1.1.1
Released March 2026.
**Bug Fixes:**
* Fix: Ticket quantity capped at 999 regardless of available tickets or per-customer
limit. Customers with bulk pricing tiers above 999 (e.g., 10,000+) could not
reach those tiers. The quantity input now derives its maximum solely from the
per-customer limit and available ticket count with no artificial ceiling.
* Fix: Range slider fallback capping quantity at 999 when no explicit maximum is
set on the input.
#### 1.1.0
Released March 2026.
**New Features:**
* New: Instant Win mode. Enable per raffle so customers find out whether they won
immediately after purchase. Two modes: probability-based (configurable odds,
e.g., 1 in 50) and guaranteed interval (one winner every N tickets). Includes
an “Instant Win!” badge on the product page, results on the thank-you page, and
instant win tags in My Account ticket list. Automatically hides offline payment
gateways when instant payment is required.
* New: Unique winner enforcement. Per-raffle toggle that prevents the same person
from winning multiple prizes in a single draw. When enabled, each user can only
win one prize tier — after a ticket holder wins, all their remaining tickets
are excluded from subsequent selections.
* New: Extend and relist expired raffles. Admins can extend a completed, failed,
or cancelled raffle by setting a new end date (tickets and winners preserved).
Relist resets the raffle to a fresh state — clears winners and terminal status
but keeps existing tickets.
* New: Guest access control. Three-way global setting: “Allow” (default, current
behavior), “Block” (show login-required message on product page), “Force login”(
redirect to login before purchase). Enforced on both the product page and the
add-to-cart validation.
* New: Payment gateway restrictions per product. Multi-select field to hide specific
gateways (e.g., COD, bank transfer) when a raffle product is in the cart. Works
standalone or automatically with instant win to hide offline gateways.
* New: Skill question time limit. Optional countdown timer for answering skill-
testing questions. When time expires, inputs are disabled and a refresh message
is shown.
* New: Skill question max attempts. Limit wrong answers per customer per product(
tracked via transients for both logged-in and guest users). After exceeding the
limit, the add-to-cart form is disabled.
* New: Multiple choice dropdown display. New compliance setting to show multiple-
choice skill answers as a dropdown select instead of radio buttons.
* New: Mixed checkout restriction. Global setting to prevent raffle and non-raffle
products from being purchased together in the same cart.
* New: Skip cart page. Per-product toggle to redirect customers directly to checkout
after adding a raffle to cart.
* New: Ticket number suffix. Per-product text field appended after ticket numbers,
complementing the existing prefix.
* New: Addon extensibility layer. Action and filter hooks (`rfwc_loaded`, `rfwc_admin_product_options`,`
rfwc_process_product_meta`, `rfwc_product_tabs`, `rfwc_after_ticket_display`,`
rfwc_frontend_scripts`) for third-party extensions and the upcoming Pro addon.
* New: Early draw when sold out. Global and per-product setting to automatically
draw winners when all tickets sell out instead of waiting for the end date. Wires
into the existing auto-close sold out option.
* New: Minimum tickets threshold for auto-draw. Per-product field to set the minimum
number of tickets that must be sold before the auto-draw can proceed. If the
threshold is not met when the raffle ends, it auto-fails and tickets become eligible
for mass refund.
* New: Raffle-specific refund emails. New ticket-refunded email sent to ticket
holders (including gift recipients) when their tickets are refunded. New admin
mass refund summary email sent after a batch refund completes. Both configurable
in WooCommerce > Settings > Emails.
* New: Allow Manual Winner Selection toggle. Admins can disable manual ticket picking
so only random draw methods are available. When off, the manual selection section
is hidden and AJAX requests are rejected.
* New: Winner Location Display setting. Choose what location to show for winners
on the frontend: City, State/Province, City + State, Country, or None. Replaces
the previous city-only display.
* New: Show Raffle Image on Winners. Displays the raffle product thumbnail beside
each winner. Useful when winners are shown outside the product page via shortcode.
* New: Show Prize Image on Winners. When the raffle prize is a WooCommerce product,
shows the prize product image beside each winner so visitors can see what was
won.
* New: Range Slider for Quantity. Optional styled range slider replaces the default
number input on raffle product pages, with min/max range and a live value indicator.
* New: Global module toggles. Enable or disable features from WooCommerce > Settings
> Raffle > Modules. Disabled modules are hidden from the product editor and frontend.
All new 1.1.0 features default to off so existing stores are unaffected.
**Bug Fixes:**
* Fix: Bulk pricing tier display showing all qualifying tiers as selected instead
of only the highest applicable tier.
* Fix: Completed raffles (winners already drawn) showing a blank product page instead
of a status message.
* Fix: Unescaped output from `wc_help_tip()` on the payment gateway restrictions
field.
* Fix: PHPCS warnings for interpolated table names in database queries placed on
wrong lines.
* Fix: Short ternary operator usage flagged by WordPress coding standards.
**Important:** All new features default to OFF. Existing installs are completely
unaffected after updating.
#### 1.0.10
Released February 2026.
**New Features:**
* New: Enhanced winner announcement banner — now displays winner’s Gravatar/profile
picture, city (from billing data), and a link to the raffle product page. City
display respects the existing `rfwc_mask_winner_name` filter for privacy. A new`
rfwc_show_winner_city` filter allows stores to disable city display.
* New: `[raffle_winners]` shortcode to display winner announcements on any page
or post. Supports attributes: `id` (required — product ID, “latest”, or “active”),`
show_avatar`, `show_city`, `show_ticket`, `show_date`, `show_link`, and `limit`.
Reuses the existing winner banner styling.
* New: Search and CSV export on the Winners, Claimed, and Mass Refund admin tabs.
All tabs are now self-sufficient with their own search box and export button,
matching the All Tickets tab functionality.
**Improvements:**
* Renamed the “Refunded” top-level tab to “Mass Refund” to clearly distinguish
it from the “Refunded” status filter within the All Tickets tab. This eliminates
the “2 refunded sections” confusion reported by users.
* Raffle filter dropdowns throughout the Tickets admin page now group raffles by
status (Active, Upcoming, Ended, Completed, Failed, Cancelled) using `