For Developers, Teachers & Streamers

Put the World's Prettiest Wheel on Your Website

Yes, you can actually put this spinning wheel on your site and look like a genius. One iframe. No account. No tracking. Just paste and go.

The Embed Code

Here it is. The whole thing. Copy it, paste it wherever you put HTML, and you're done. It really is that straightforward.

<iframe
  src="https://namewheel.org"
  width="100%"
  height="600"
  frameborder="0"
  style="border-radius: 12px; overflow: hidden;"
></iframe>

The width="100%" means the wheel will scale to fit whatever container you put it in. The height="600" gives it enough room to breathe. You can adjust both to fit your layout. Going below 400px tall starts to make things cramped, but it technically still works.

The border-radius: 12px rounds the corners so it doesn't look like a 2002 iframe. You're welcome.

Customizing Your Embed

Want the wheel to show up pre-loaded with names? Use the #names= hash parameter in the URL. Names are comma-separated. Spaces are fine. The wheel will be ready to spin the moment someone loads your page.

Here are four examples showing how to customize the embed for different situations:

https://namewheel.org#names=Alice,Bob,Charlie,Diana

Loads the wheel pre-filled with four names. Your visitors can spin immediately without typing anything. Great for embedding in a specific page where the roster never changes.

https://namewheel.org#names=Team%20A,Team%20B,Team%20C

Spaces in names need to be URL-encoded as %20. So "Team A" becomes "Team%20A". Most modern frameworks will handle this automatically if you build the URL programmatically.

https://namewheel.org#names=Monday,Tuesday,Wednesday,Thursday,Friday

The wheel doesn't care if you put in names, days, tasks, or whatever. It just spins. Use it for picking a day of the week, a task from a list, or choosing who brings donuts to the office.

https://namewheel.org#names=Option%201,Option%202,Option%203,Option%204,Option%205,Option%206

More options, more fun. The wheel handles up to a large number of entries gracefully. It adjusts the slice sizing automatically so everything stays readable.

Using the hash parameter in your iframe src

<iframe
  src="https://namewheel.org#names=Alice,Bob,Charlie"
  width="100%"
  height="600"
  frameborder="0"
  style="border-radius: 12px; overflow: hidden;"
></iframe>

The names parameter goes in the src URL after the hash. The iframe loads the wheel with those names already in the list, ready to spin on the first click.

Embed Use Cases

People embed NameWheel in some genuinely clever ways. Here are the most common ones, plus a few that surprised us.

🏫

Teachers on Google Sites

Google Sites supports iframes through the "Embed" block. Drop the code in, add your class roster to the URL, and you've got a cold-call wheel that lives on your class page permanently. Students love it. You'll love the silence when you hover over the spin button.

🎮

Streamers and OBS

OBS and Streamlabs both support Browser Sources. Point the Browser Source URL at namewheel.org#names=..., set the dimensions, and the wheel becomes part of your stream overlay. Viewers see you spin live. Chat goes wild.

✍️

Bloggers and WordPress

Writing a post about decision-making, team management, or random selection? Embed the wheel directly in the post. Your readers get an interactive tool instead of a static screenshot. Dwell time goes up. Bounce rate goes down. You look thoughtful.

🏢

HR Teams and Intranets

Internal wikis on Confluence, Notion, or SharePoint can embed iframes. HR and team leads use NameWheel for picking volunteers, assigning rotating duties, choosing the monthly team lunch spot, and other situations where "whoever makes eye contact first" is not a fair system.

A few more situations where this makes sense

Event websites use it for raffle drawings during live events. Course platforms embed it so instructors can do random Q&A selection without downloading an app. Escape room operators embed it on booking confirmation pages as a fun pre-game activity. Student project groups use it to fairly assign roles without arguing. Really, anywhere you would otherwise reach for a random number generator or flip a coin, the wheel is just more interesting.

Technical Details

If you're the kind of person who reads technical details sections, this one is for you. Here is exactly what the embed does and doesn't do.

✓ HTTPS only. NameWheel is served exclusively over HTTPS. Embedding it on an HTTP page will trigger a mixed-content warning in most browsers. If your site is still on HTTP in 2025, the embed is the least of your problems.
✓ No cookies set. The NameWheel iframe does not set any cookies, first-party or third-party. You do not need to update your cookie banner because of this embed.
✓ No data sent to our servers. The names you put in the wheel via the hash parameter are processed entirely in the visitor's browser. They are never transmitted to namewheel.org servers. The server just serves the HTML, CSS, and JavaScript. That's the end of its involvement.
✓ No iframe permissions required. The embed does not use camera, microphone, geolocation, or any other browser permission. There is nothing to allow-list in a permissions attribute.
✓ Lightweight. The page loads fast. The wheel is rendered in HTML Canvas with no heavy dependencies. Total page weight is small. It will not meaningfully slow down your page.
✓ Cross-origin sandboxed. Because it runs in an iframe, NameWheel's JavaScript is completely sandboxed from your parent page. It cannot read your DOM, access your cookies, or interact with your page's JavaScript in any way.
✓ No Content Security Policy conflicts (usually). If your site has a strict CSP with frame-src set, you'll need to add https://namewheel.org to that directive. That's a one-line CSP update.

Frequently Asked Questions

Is it free to embed?

Yes. Completely free. No account, no API key, no rate limit, no watermark you have to pay to remove. Copy the iframe code, paste it in, done. We might add a premium tier someday with extra features, but the core embed will always be free.

Will the embed break if NameWheel changes the site?

We maintain backward compatibility with the embed URL and the names hash parameter. If we make breaking changes, we'll keep the old behavior working at the same URL. The iframe pointing at namewheel.org should keep working without you touching anything.

Can I use this on a commercial website?

Yes. There are no restrictions on the type of website you embed it on. Commercial sites, paywalled platforms, internal tools, public-facing apps. All fine. If you're building something at scale and want to talk about a partnership, reach out through the contact page.

My platform doesn't allow iframes. What can I do?

Some platforms block iframes as a security measure. Google Classroom, for example, restricts embeds in certain contexts. In those cases, your best option is to link to namewheel.org directly and let users open it in a new tab. We're working on a JavaScript widget as an alternative to the iframe for more restrictive environments.

The wheel shows up but the spin button doesn't work inside the iframe. Why?

This is usually a browser security feature blocking interaction with cross-origin iframes in certain contexts. Make sure your page doesn't have a sandbox attribute on the iframe that blocks scripts. The iframe should work without any sandbox attribute. If you're embedding inside a shadow DOM or web component, there are some extra considerations around pointer events.

Can I resize the iframe to be smaller than 600px?

You can set the height to anything you want. The wheel is responsive and will scale to fit. Below about 380px tall, the layout starts to get tight and the name input area becomes awkward. For very small embeds, consider linking out to the full page instead of embedding at a cramped size.

Does the embedded wheel work on mobile?

Yes. The wheel is fully touch-enabled. Visitors on phones and tablets can tap the spin button and interact with all the controls. The iframe itself is responsive, and if you set the width to 100% it will adapt to the screen width of the device viewing your page.

Ready to Add the Wheel?

Go try the wheel yourself first, then come back here and grab the embed code. It takes about 45 seconds total.

Open NameWheel