Advanced Instant Win
Advanced Instant Win#
Extends the core Instant Win system with pre-selected winning tickets, separate prize configuration, and hybrid mode. See the Instant Win documentation for full details.
Enabling#
- Enable Instant Win in the core raffle settings first.
- In the PRO Features section, check Instant Win: Pre-selected for pre-selected ticket features.
- The IW prize configuration section appears automatically when Instant Win is enabled.
Pre-selected tickets#
Designate specific ticket numbers as guaranteed instant winners:
- Manual entry: Type comma-separated ticket numbers (e.g.,
0001, 0015, 0042). - CSV import: Upload a CSV with
ticket_number,prize_tierper line. The tier column is optional (defaults to 1). - Clear all: Remove all pre-selected tickets with one click.
Ticket number matching handles zero-padding automatically — 0042 and 42 are treated as the same ticket.
Prize tier labels#
Configure up to 5 cosmetic tier labels for the frontend:
| Field | Description |
|---|---|
| Tier Label | Display name (e.g., “1st Prize”, “Runner Up”) |
| Tier Description | Prize details (e.g., “£500 cash prize”) |
Separate IW prize configuration#
When Instant Win is enabled, a new IW Prize section appears in the product panel with its own prize type, independent of the main draw:
| Setting | Description |
|---|---|
| IW prize type | Product from store, Store credit / Coupon, or Custom |
| IW prize products | WooCommerce product search per tier (1-5) — only visible when type is “Product” |
| IW credit amounts | Credit/coupon amount per tier — only visible when type is “Store credit” |
| IW descriptions & values | Custom prize text and display value per tier — only visible when type is “Custom” |
| Auto-fulfill IW prize | Automatically create a free prize order or credit coupon for instant winners |
When configured, instant winners receive prizes from the IW config. Main draw winners receive prizes from the core config. If no IW prize type is set, both share the core config (backward-compatible).
Two chances to win#
In hybrid mode (instant win + end-date draw both active), a “Two chances to win” checkbox appears:
- Enabled: Instant win tickets keep
'active'status and remain eligible for the main draw. The ticket holder can win an instant prize AND potentially win the main draw. - Disabled (default): Instant win tickets get
'winner'status and are excluded from the main draw pool.
This toggle is hidden in IW-only mode (no main draw to stay eligible for).
Frontend display#
When separate IW prizes are configured, the product page shows two sections:
- Instant Win Prizes — tier cards with actual prize data (product names, credit amounts, or descriptions).
- Main Draw Prize — heading above the core prize display (hidden in IW-only mode).
When no separate IW config exists, the original cosmetic tier cards display instead.
Admin labelling#
When Instant Win is enabled in hybrid mode, the core prize section in the product panel is labelled “Main Draw Prizes” to clearly distinguish it from the IW prizes above.