Free to use

Embed the Hand Rankings Chart

One script tag puts a poker hand rankings chart on your site. No iframe, no external requests, no tracking, about 2.5KB gzipped. Free for any site — commercial or otherwise — as long as the attribution link stays.

The snippet

Paste this where you want the chart to appear. That is the entire setup.

Basic embed

<script src="https://sharkling.io/embed/hand-rankings.js"></script>

Live preview

This is the real widget, loaded exactly as the snippet above loads it.

Placing it somewhere specific

If the script tag can’t sit where you want the chart — a lot of CMSes move scripts to the end of the body — give it a target element.

Targeted embed

<div id="poker-hand-rankings"></div>
<script
  src="https://sharkling.io/embed/hand-rankings.js"
  data-target="#poker-hand-rankings"
></script>

Options

All options

<script
  src="https://sharkling.io/embed/hand-rankings.js"
  data-target="#poker-hand-rankings"
  data-theme="dark"
  data-compact="true"
></script>

data-target: A CSS selector for the element to render into. Omit it and the chart renders where the script tag sits.
data-theme: light, dark, or omit for auto, which follows the visitor’s system setting and updates if they change it.
data-compact: true for a tighter layout that fits a sidebar.

Version pinning

The unversioned URL always serves the latest major version, so you get improvements without doing anything. If you would rather nothing ever changed, pin to a major:

Pinned to v1

<script src="https://sharkling.io/embed/v1/hand-rankings.js"></script>

Pinned URLs are cached for a year and never invalidated. That is the deal — it also means a fix reaches you only when your visitors’ caches expire. v1 will keep being served indefinitely; a breaking change becomes v2 at a new URL rather than altering this one.

What it does and does not do

The widget renders into a Shadow DOM, which is the part that matters if you have ever had a third-party embed wreck your layout. Your CSS cannot reach inside it and its CSS cannot escape. It is tested against a host page that tries to override everything with !important, which is how a real leak was found and fixed before launch: shadow roots block selectors but not inherited properties, so the widget explicitly re-establishes every inheritable property internally.

It makes no network requests after the script itself. No web fonts, no images, no sprite sheet, no analytics beacon. The card suits are Unicode characters and the layout is plain CSS. Nothing about the widget needs to appear in your cookie banner.

It touches exactly one global, window.__sharklingEmbed, which carries the version for support purposes. It does not patch prototypes, register service workers, or listen for events on your page.

The attribution link

The footer carries a normal, followable link back to the hand rankings chart. That link is the entire business model for giving this away, so please leave it in. Everything else — the theme, the density, where it sits — is yours to change.

If you want a variant that doesn’t exist yet, or the chart in a different language, get in touch and we will probably just build it.

Embed questions

Is the widget free to use?

Yes, on any site, commercial or not. The only condition is that you leave the attribution link in place — that link is what pays for the widget.

Does it track my visitors?

No. It sets no cookies, makes no requests after the script itself, and sends no analytics of any kind. There is nothing to disclose in your privacy policy beyond the fact that the script is served from sharkling.io.

Will it break my site's styling?

No. The widget renders inside a Shadow DOM, so its styles cannot escape into your page and your page's styles cannot reach into it. It is tested against a host page that deliberately tries to override everything with !important.

How big is it?

About 2.5KB gzipped, and the build fails if it ever exceeds 30KB. It loads no fonts and no images — the card suits are text characters and the layout is CSS.

Will the widget change under me?

The unversioned URL follows the latest major version and may gain improvements. If you want a frozen contract, use the pinned URL — it never changes and is cached for a year.

Does it work on mobile?

Yes. It fills whatever container you put it in, and the example cards are hidden below 420px so the layout stays readable on a phone.

Back to the interactive hand rankings chart, or browse all the free poker tools.