What the embed is and where it works
ChoiceSpin hosts an embed builder at /embed. You build the wheel there: type the entries, decide how visitors interact, and watch a live preview change as you adjust things. When it looks right, the builder hands you a short piece of HTML for your own page.
That HTML wraps a sandboxed iframe. The frame loads a stripped-down, wheel-only page from choicespin.com, so the spinner keeps its own code fully separate from yours. Anywhere you can paste raw HTML, the wheel can live: a blog post, a documentation page, a course site, an intranet.
None of this requires registration. You do not create an account to build the embed, and your visitors do not need one to spin it.
From list to live wheel in four steps
1. Open the embed builder and enter your options, one line each. An embedded wheel holds 2 to 100 entries of up to 80 characters.
2. Choose the visitor controls. Clicking the wheel spins it, an on-screen button does the same job more visibly, or you can let visitors edit a local copy of the list.
3. Set the look. Pick a light, dark, or transparent background, one of three color palettes, a spin length between 1 and 15 seconds, and an optional title.
4. Copy the generated snippet and paste it wherever your page accepts HTML.
The snippet is a responsive wrapper around an <iframe> whose src points at the wheel-only page, choicespin.com/e. Your whole setup rides along in that address, encoded as a single token after #w=. There is nothing to install and no key to manage, and rebuilding with new settings simply produces a fresh snippet.
Pasting it into WordPress, Notion, Google Sites, or plain HTML
Every mainstream site builder has a block that accepts raw HTML, and that block is all the wheel needs. WordPress calls it a Custom HTML block. Google Sites reaches it through Insert and then Embed. Squarespace and Wix offer code or embed elements, though certain plans restrict iframes, so check a preview before publishing.
Some tools take a link rather than pasted code, with Notion's embed block the common example. For those, switch the builder's output from Embed code to Direct URL and paste the wheel-only link on its own.
On a hand-written HTML page, drop the snippet straight into the body. The wrapper carries an aspect ratio, so the wheel scales to whatever column it sits in without a fixed height.
How it behaves on your page
The copied iframe declares loading="lazy", letting browsers defer the wheel until a reader scrolls near it, and its sandbox attribute limits the frame to running its own scripts. Sound stays off unless you enable a finish sound, and even then it begins only after the visitor has interacted with the frame.
Visitors can drive the wheel from the keyboard: it responds to Space or Enter when focused, and the optional on-screen controls are actual button elements.
One thing to plan around: your entries are part of the embed address itself. Anyone who reads your page source or receives the link can see the full list, so keep private names and anything sensitive out of an embedded wheel.
Two boundaries hold on every embed. Visitor edits, where you allow them, exist only inside that visitor's copy of the frame and never flow back to your page or to a wheel you saved on ChoiceSpin. And the wheel-only page carries a noindex tag, so search engines rank your surrounding article rather than the frame inside it.
Each entry on an embedded wheel starts with the same chance on every spin. The fairness page walks through how a winner gets picked.
Driving the wheel from your own code
Plain pasting covers most uses, but a developer can also script the frame. The runtime accepts versioned window messages for five actions: spin, setEntries, addEntry, removeWinner, and reset.
It reports back as it works, emitting ready, spin-start, spin-end, entries-changed, and error. That is enough to trigger a spin from your own button, feed entries in from your own form, or react the moment a winner lands, all while the iframe sandbox stays exactly as copied.
Winner removal has one guard worth knowing: an embedded wheel never drops below two entries, no matter how the removal was requested.
When a link beats an embed
The embed is deliberately compact, and some jobs outgrow it. It tops out at 100 entries, and it has no weighting, saving, or history of its own.
For those jobs, point people at the full ChoiceSpin editor instead. It takes up to 2,000 entries, supports Advanced weights when equal chances are not what you want, saves wheels locally under My Wheels, backs them up as downloadable .wheel files, and keeps a local Results history of recent winners. Auto remove winner is there too, and it stops once two entries remain. Where private hosted sharing is enabled for an environment, Share can also produce a hosted link.
Streaming is its own path. If the wheel is headed for OBS or a similar tool rather than a web page, the stream overlay builder produces a Browser Source URL instead of an iframe.
Embed questions
Do I need an account to create or serve the embed?
No. The builder is free, has no sign-in, and the wheel it generates keeps working without an account on either side.
Can visitors change my wheel?
Only if you pick the local editing option, and even then their changes exist solely in their own copy of the frame. Your page and anything you saved on ChoiceSpin are unaffected.
How many entries can an embedded wheel hold?
Between 2 and 100, each up to 80 characters. Bigger lists belong on the full wheel, which handles up to 2,000 entries.
Will the iframe slow my page down?
The wheel runs inside its own frame, and the copied snippet asks the browser to load it lazily, so browsers can wait until the reader scrolls near it before fetching anything.
What if my site builder refuses iframe code?
Use the Direct URL output instead. It gives you the wheel-only link, which fits URL-based embed blocks or works as an ordinary link for visitors to open.
Can I remove the ChoiceSpin credit under the wheel?
Yes. The builder includes a toggle for the small Create your own wheel link, and switching it off before you copy the code leaves the wheel unbranded.
Build your wheel embed
Open the builder, type your entries, and copy the code. The live preview shows exactly what your visitors will get.