Embeddable widgets
Put Our Paint Data On Your Site
Free paint-matching widgets for blogs, shops, club sites and wikis. Paste one line of HTML. You don't need to ask us, register, or hold a key — and nothing here costs anything.
The licence, in three lines
- Anyone may embed it. Commercial or not, any number of pages, no permission needed and no attribution beyond what the widget already shows.
- Keep it unmodified. Frame the page as it is served. Don't restyle it through the frame, strip its links, or wrap it so the links stop working.
- That's the whole deal. The links inside are how we're paid — affiliate commission when a reader goes on to buy. Stripping them is taking the data and leaving the bill, which is the one thing that would make us stop offering this.
We may change or retire a widget, so don't build anything load-bearing on it. If one disappears, the iframe renders nothing rather than breaking your page.
Colour picker
A colour swatch your reader can change, and the closest real paints to it across every range we hold — Citadel, Vallejo, Army Painter and 35 brands in all. Each result links to that paint's page, where the prices are.
Live widget — this is the real thing, not a screenshot.
Paste this
<iframe src="https://paintpicker.co.uk/embed/colour-picker?hex=7a5230&limit=5"
width="100%" height="340" style="border:0"
loading="lazy" title="Paint colour matcher"></iframe>Options
| Parameter | Values | What it does |
|---|---|---|
| hex | 7a5230 or 7a5 | The colour it opens on. Leave the # off — a # ends the query string. |
| limit | 1–12 (default 5) | How many paints to list. |
| theme | light · dark | Light by default; dark for dark pages. |
| market | uk · us · ca · au · eu | Forces one market’s prices. Omit it and each reader gets their own, detected from their browser. |
| title | any short text | The heading above the list. |
Out-of-stock alternatives
Built for shop product pages: when a paint is out of stock, this panel shows the closest colours that shop can ship today, from their own catalogue, each through their own link. Add ?store= and it scopes itself to that shop — which is what makes it useful on a shop's page, and what any other site would leave off. It renders nothing at all when it can't answer well: an empty box on a live product page is worse than no box.
Live widget, showing what Loaded Dice can ship instead of Abaddon Black — real stock, real prices, their links.
Paste this
<iframe src="https://paintpicker.co.uk/embed/alternatives?store=YOUR-STORE-ID&limit=4"
width="100%" height="320" style="border:0"
loading="lazy" title="In-stock alternatives"></iframe>| Parameter | Values | What it does |
|---|---|---|
| store | your store id | Required. Scopes the panel to that shop’s catalogue and links. |
| paint | a paint id | The out-of-stock paint to find alternatives to. |
| limit | 1–8 (default 4) | How many alternatives to show. |
| theme | cream · light · dark | Cream by default — neutral on a shop’s own page. |
It only works for shops whose catalogue and stock we already hold, so store has to be one we know — an id we don't recognise renders nothing rather than an empty frame. If you run a paint shop and want to be on that list, get in touch; it costs you nothing and it keeps the sale on your own page.
Questions people ask first
- Do I need an account or an API key?
- No. It is a URL in an iframe. Nothing to sign up for and nothing to configure.
- Will it show the right prices for my readers?
- Yes — leave the market parameter off and each reader is sent to their own market’s prices, worked out from their browser’s timezone and language. Set it explicitly if you would rather pin everyone to one, which is usually right for a shop’s own blog.
- Does it cost anything, or track my readers?
- It is free. The widget sets no cookies and identifies nobody; it counts how often it is shown so we know whether to keep building them.
- Can I change the colours to match my site?
- Pick light or dark, and the rest stays as served — that is the one condition of the licence. If neither theme fits your page, tell us and we will look at adding one.
- How tall should the frame be?
- 340px suits the default five results. Add roughly 44px per extra paint if you raise the limit.
- What happens if you retire it?
- The frame renders empty rather than breaking your layout. We would not remove one without a long notice on this page.