Documentation

RaffleKit Complete Guide

Everything you need to set up, run, and complete a successful community raffle — from first login to announcing the winner.

⏱️ 10-min setup 🏆 Prize baskets 🎟️ Ticket reservations 🖨️ Print poster 📱 Social cards 🎬 Live draw
Start here

Quick-start checklist

Complete these steps in order and your raffle will be ready to share in under 10 minutes.

  • Log in to your admin panel using the password emailed to you
  • Go to Settings → fill in your organisation name, raffle title, and story
  • Set your draw date and ticket pricing (e.g. $5 each, 5 for $20)
  • Enter your NZ bank account number for ticket payment instructions
  • Go to Baskets → create each prize basket with a name, photo URL, items, and estimated value
  • Save settings and preview your public raffle page
  • Download your print poster (Share → Print tab → Save as PDF)
  • Download your Instagram and Facebook share cards
  • Share your raffle URL on Facebook, WhatsApp groups, and email
  • As orders come in, confirm payments in the Orders tab
  • On draw day, gather two witnesses and click Pick Winner
  • Contact the winner and arrange prize collection
Access

Logging in to your admin panel

Your admin panel is at a URL that looks like:

https://yourraffle.rafflekit.co.nz/admin.html

You will have received this URL and your password by email when your account was activated. The default password is shown on the login screen — change it on first login.

⚠️

Keep your password safe. Anyone with the admin URL and password can manage your raffle, edit settings, confirm payments, and run the draw.

yourraffle.rafflekit.co.nz/admin.html

🔐 Admin Login

Enter your admin password to manage your raffle

••••••••
Sign In →

Changing your password

Go to Settings → Security in the admin panel and enter a new password. Write it down somewhere safe — there is no password reset flow.

Admin Panel

1. Raffle settings

The Settings tab controls everything that appears on your public raffle page. Complete all fields before you start sharing your link.

FieldWhat it doesExample
Organisation nameShown in the nav and hero sectionGreenfield Sports Club
Raffle titleThe headline on your raffle pageSpring Raffle 2026
TaglineShort sentence under the titleSupport our club and win amazing prizes!
Our storyA paragraph about your organisation and what the money will fundWe're a local sports club raising funds for new gear…
Ticket priceCost per individual ticket5.00
Bundle quantityNumber of tickets in the bundle deal5
Bundle priceTotal price for the bundle20.00
Max ticketsTotal tickets available for sale200
Draw dateWhen the raffle closes and draw is held2026-06-30
Bank accountNZ bank account for ticket payments38-9026-0669416-01
Bank nameName on the accountGreenfield Sports Club
Contact emailShown on social cards and postertreasurer@greenfieldsc.org.nz
Contact phoneOptional, shown on poster021 000 0000
Admin passwordPassword to access this admin panel(keep secret!)
💡

Tip: Write your "Our story" section as if you're explaining to a stranger why they should buy a ticket. Mention the cause, what the money funds, and something personal about your group. It builds trust and increases sales.

Admin Panel

2. Prize baskets

Prize baskets are the heart of your raffle. Each basket is a separate prize that buyers can direct their tickets toward. The more appealing your baskets are, the more tickets you'll sell.

Click "Add Basket" in the Baskets tab

A form will slide open. Fill in all fields for the best presentation.

Enter a basket name and emoji

Keep it short and vivid: 🍷 Gourmet Food Hamper, 🧖 Pamper & Relax, 🏕️ Adventure Outdoors

Add a photo URL

Take a photo of your assembled basket and upload it to a free service like imgbb.com or imgur.com. Copy the direct image link and paste it here. This photo appears on the public page, social cards, and print poster.

List the items inside

Enter each item on its own line. Be specific — "Bottle of Hawke's Bay Merlot" is better than "Wine". The item list appears on the public page and print poster.

Set an estimated value

Enter the approximate retail value of the basket (e.g. $120). This is shown as "Est. Value $120" and gives buyers a sense of how good the prize is.

Save the basket

Click Save. The basket will appear immediately on your public raffle page — no refresh needed.

💡

Best practice: Aim for 3–6 baskets with distinct themes so different buyers find something they want. A food hamper, a spa experience, and a sports/activity basket cover most audiences well.

Getting photos without a photographer

Lay your basket items out on a table with good lighting. Use your phone camera in portrait mode. A clean background (white tablecloth or grass) works best. Upload to imgbb.com, click "Copy URL", and paste into the basket photo field.

Admin Panel

3. Managing orders

Every ticket reservation submitted by a buyer appears in the Orders tab. Orders start with status pending until you confirm payment.

⏳ Pending ✅ Paid ❌ Cancelled
ColumnMeaning
RefUnique reference code the buyer uses when making their bank deposit
NameBuyer's full name
Email / PhoneContact details for prize notification
TicketsTotal number of tickets reserved
AllocationsHow the buyer split their tickets across baskets
Amount DueTotal payment expected
Statuspending / paid / cancelled
ActionsMark as paid, mark as cancelled, view details

Searching and filtering

Use the search bar at the top of the Orders tab to filter by name, email, or reference code. Use the status dropdown to view only pending or paid orders.

Admin Panel

4. Confirming payments

RaffleKit uses a bank-deposit payment model. Buyers are given clear payment instructions including your bank account number and a unique reference code.

Check your bank account

Log in to your online banking. Look for deposits with the reference code matching an order in your admin panel. References follow the format RK-XXXX.

Find the order in RaffleKit

In the Orders tab, search by reference code or buyer name. Click on the order to open it.

Click "Mark as Paid"

The order status changes to Paid (green). The tickets are now active and eligible for the draw.

Optionally notify the buyer

Drop them a quick text or email: "Hi [Name], your [X] RaffleKit tickets are confirmed! Good luck in the draw on [date]."

⚠️

Important: Only tickets with status Paid are eligible for the draw. Do not include pending orders in the winner pick. The draw system only draws from paid orders.

Marketing

Social share cards

RaffleKit generates ready-to-post images for Instagram and Facebook using your real raffle data — no Canva or design skills needed.

📸 Instagram card (1080×1080)

Square format, ideal for your Instagram feed. Features your basket photos in a grid, headline, draw date, and pricing on a gradient background.

How to use: Download the image → open Instagram → create a new post → select the image → add the copied caption to your post. Done!

📘 Facebook card (1200×630)

Landscape format, ideal for Facebook posts and link previews. Features a split-panel design with your raffle details on the left and prize photos on the right.

How to use: Download the image → create a Facebook post → attach the image → paste the copied caption. Your raffle URL goes in the post text.

💡

Caption tip: The auto-generated caption is a good starting point. Add a personal line at the top, e.g. "We're so excited to announce our raffle! 🎉" to make it feel human before you post.

Steps to generate and download

  1. Click 📣 Share in the navigation bar on your public raffle page
  2. Choose the Instagram or Facebook tab
  3. Click ⬇ Download Image
  4. Click 📋 Copy Caption to copy the pre-written post text
  5. Post the image + caption on your social media
Draw Day

Preparing for the draw

Before the draw date arrives, complete these steps to ensure everything runs smoothly and transparently.

  • Confirm all payments have been processed — only Paid orders enter the draw
  • Contact any Pending buyers to chase payment or cancel their order
  • Arrange for two witnesses who are not entering the raffle to be present (in person or on a video call)
  • Have your raffle URL and admin panel open and ready on a device everyone can see
  • Consider a Facebook Live stream so your community can watch the draw happen
  • Make sure you have the winner's contact details on file to reach them quickly
⚠️

Transparency matters: Running the draw publicly — even on a Facebook Live — builds trust and encourages people to enter future raffles. The two-witness approval is built into RaffleKit to support this.

Draw Day

Running the draw

Go to admin.html → Draw tab

Log in to your admin panel and click the Draw section in the sidebar.

Review the eligible tickets

The draw screen shows how many paid tickets are eligible. Verify this number looks right before proceeding.

Click "🎬 Start Draw"

A drum-roll animation plays while the system randomly selects a winning ticket. The winner's name is hidden until both witnesses approve.

Witness 1 enters their name and clicks "Approve"

The first witness confirms they have watched the draw process fairly.

Witness 2 enters their name and clicks "Approve"

The second witness confirms. Both approvals are required before the result is revealed.

🎉 Winner revealed!

The winner's name, email, and ticket details appear on screen with a celebration animation. Screenshot or record this moment for social media.

Draw Day

Two-witness approval

The two-witness requirement ensures your draw is transparent and cannot be manipulated. This is important for maintaining trust in your community.

Who can be a witness?

  • Any adult who is not entering the raffle themselves
  • Ideally someone your community knows and respects (a club committee member, local business person, etc.)
  • Can be present in person or watching via video call
  • Their names are recorded in the draw record as part of the audit trail
💡

Tip: Ask witnesses to introduce themselves on any live stream before the draw so viewers can verify who they are. This adds another layer of transparency.

Draw Day

After the draw

  • Screenshot the winner announcement and post it on your social media
  • Contact the winner directly (email + phone) within 24 hours
  • Arrange prize collection or delivery
  • Post a thank-you message to all participants
  • Log in to admin → Settings and mark the raffle as Closed
  • Export your orders list for your club records
💡

For next time: While it's fresh, note what worked and what you'd do differently. How many days did you promote? Which basket sold best? Use this to plan an even better raffle next time.

Buyer Guide

How to reserve tickets (for buyers)

Share this section with your ticket buyers so they know exactly what to do.

Open the raffle link

Click the link shared by your club on Facebook, WhatsApp, or email. You'll see the prize baskets and pricing.

Click "Reserve My Tickets"

A four-step reservation form opens. It guides you through everything — no confusion, no missing steps.

Step 1 – Choose how many tickets

Use the + and − buttons or type a number. The total cost is shown as you type. Bundle deals are applied automatically.

Step 2 – Allocate tickets to prize baskets

Decide how many of your tickets go into each basket. You must allocate all your tickets before you can continue. You can put all your tickets into one basket or spread them across several.

Step 3 – Enter your details

Your name, email, and phone number. These are used to contact you if you win.

Step 4 – Payment instructions

You'll see the club's bank account number and a unique reference code. Copy the reference code — you must include it in your bank transfer so the club can match your payment to your order.

Buyer Guide

Making payment (for buyers)

  1. Log in to your online banking
  2. Create a new payment to the bank account number shown on the reservation confirmation screen
  3. Important: In the "reference" or "particulars" field, enter your unique reference code exactly as shown (e.g. RK-A1B2C3)
  4. Enter the correct amount (shown on the confirmation screen)
  5. Complete the transfer. The club will mark your order as paid once the payment arrives, usually within 1–2 business days.
💡

Buyers: If you're unsure whether your payment was received, use the "Check My Order" button on the raffle page. Enter your name or email to see your order status.

Buyer Guide

Looking up your order (for buyers)

At any time, buyers can check the status of their order without needing a login.

Click "Check My Order" in the navigation

A lookup panel slides open.

Enter your name or email address

Your order details will appear: number of tickets, basket allocations, amount due, and payment status.

Check the status

Pending = payment not yet confirmed. Paid = your tickets are confirmed and eligible for the draw!

Best Practices

Tips & best practices

🏆 Prize basket tips

  • Aim for 3–6 baskets with distinct appeal to different buyers
  • Always use a real photo of the assembled basket — not stock images
  • Include local NZ products if possible; people love supporting local
  • Reveal baskets one at a time on social media for ongoing excitement
  • Estimated values help buyers decide — don't skip this field

📣 Promotion tips

  • Post your raffle at least 2–3 weeks before the draw date
  • Share a countdown post 7 days before, 3 days before, and on the last day
  • "One week to go" urgency posts are your biggest sales driver
  • Ask committee members and supporters to share the post to their personal feeds
  • A personal story about why you're fundraising always outperforms generic posts

💰 Pricing tips

  • $5 per ticket or 5 for $20 is the most common and popular NZ community raffle price point
  • $2 per ticket or 3 for $5 works well for lower-value baskets (Easter hampers, grocery bundles)
  • A bundle deal (e.g. 5 for $20) increases average order value significantly
  • Set your max tickets based on how many you can realistically sell — 100–200 is typical for a club raffle

📅 Timeline

WhenWhat to do
3 weeks outLaunch your raffle page, post the first announcement with all basket reveals
2 weeks outPost your print poster in the club and share the social card again
1 week out"One week left!" urgency post on Facebook + WhatsApp group reminder
3 days outFinal reminder post, chase any pending payments
Day beforeClose orders, confirm all payments, brief your two witnesses
Draw dayRun the draw live (or on Facebook Live), reveal the winner, post the result
Day afterContact winner, arrange prize, post thank-you to all participants
Help

Troubleshooting

My basket photos aren't showing up

Make sure your photo URL is a direct link to the image file (ending in .jpg, .png, etc.) not a page that contains the image. On imgbb.com, right-click the image and select "Copy image address" to get the correct URL.

The social share card shows placeholder text

The share cards pull data from your saved settings and baskets. Make sure you have saved your settings and added at least one basket. Then close and reopen the share modal.

An order isn't showing in the draw

Only orders with status Paid are eligible for the draw. Check the order in the admin panel and mark it as paid if payment has been received.

I forgot my admin password

Email hello@ruihalabs.com with your organisation name. We'll verify your identity and reset your password within one business day.

The print poster cuts off on my printer

In the print dialog, set margins to "None" or "Minimum" and make sure "Fit to page" is selected. Use A4 paper size. For best results, choose "Save as PDF" and take the PDF to a print shop.

A buyer says they can't find their order

Ask them to click "Check My Order" and search by email. If it still doesn't appear, check the Orders tab in admin — their name might be spelled differently. They may also not have completed the reservation form — they may need to start again.

📬

Still stuck? Email hello@ruihalabs.com and we'll help you sort it out.