Show competitions
Embeddable widget
One script tag puts your live competitions on any page, with checkout in a secure popup. No API key, no backend.
<script src="https://www.bitraffle.io/widget.js" data-org="your-org"></script>The script adds a responsive frame where it is placed and touches nothing else on your page. It takes your brand colour automatically, and its cards update themselves as competitions sell and close.
| Attribute | Required | Value |
|---|---|---|
data-org | Yes | Your organisation's slug: your-org. |
data-competition | No | A competition id. With it, the widget shows that one competition (single mode); without it, a grid of all your live competitions. |
Live preview
This is the real widget, running with BitRaffle's live competitions.
Single-competition mode
Add data-competition to feature one competition: a larger photo, the ticket price, a live countdown, how many tickets are left, and an entry button. It suits a campaign landing page or a blog post.
<script src="https://www.bitraffle.io/widget.js"
data-org="your-org"
data-competition="71"></script>How checkout works
A visitor picks how many tickets they want and presses enter. Checkout opens in a popup on our domain: sign-in by email or wallet, the entry question, then payment. When it completes, the widget updates in place. Your page never navigates away.
Use your own frame
Prefer to size and place the frame yourself? Point an iframe at the embed page directly:
<iframe src="https://www.bitraffle.io/embed/your-org"
style="width:100%;border:0;min-height:520px"
loading="lazy" title="Competitions"></iframe>| Path | Shows |
|---|---|
/embed/your-org | All live competitions. |
/embed/your-org/competition/{id} | One competition. |
/embed/your-org/results/{id} | One competition's result: the winner and how they were drawn. |
Share images
Every competition has a 1200 × 630 social card at https://www.bitraffle.io/og/competition/{id}.png. Use it as the og:image of your own pages so links to them unfurl with the prize.