Developer reference
Open a prepared draw from another site: URL parameters, a share token, hosted CSV, inline CSV data, and a postMessage handoff, with limits and code samples.
A linking page builds a URL, or opens the app and sends a message. The app parses names, labels and settings in the browser; there is no API key and no backend.
campaign Campaign name shown above the wheel. Up to 120 characters.prize Prize label printed under the campaign name.name One participant per occurrence, up to 500 names.names A pipe-separated list in a single parameter.palette A wheel palette id. Use custom together with colors for your own colours.colors Three hex colours, comma separated and URL-encoded.theme light or dark.csv HTTPS URL of a CSV that allows CORS. Downloaded and parsed in the browser.csvdata Base64url CSV text carried inside the link, under 60,000 characters.unique Header used as the unique key for CSV lists.display Header printed on the wheel for CSV lists.autostart 1 loads the built-in sample list for demos.#setup Base64url JSON token with settings and participant rows.https://luckyfinder.pages.dev/?campaign=Launch+Night&prize=Gold&name=Aung+Ko+Ko&name=Su+Myat+Noe&theme=dark
A link that carries participants opens the Wheel Stage. A link that carries only settings opens the participant step with those settings ready.
Anything in a link is readable by whoever holds it. Use a hosted CSV, inline CSV or a postMessage handoff when the list contains personal data. Winner records stay encrypted in the browser.