Embed your weather elsewhere

Your station can appear on other people's websites. Two formats cover everywhere: a small widget you drop into a page with an iframe, and a badge image for the places that do not allow iframes, like forum signatures and READMEs.

Both are on for every plan, they need no account from whoever hosts them, and both link back to your station.

Getting your snippet

Open your site in the dashboard, go to Publishing, and find "Put your weather on another site". Pick a size, theme, units and language, check the live preview, then copy one of the four snippets: iframe, HTML image, Markdown or BBCode.

The widget

<iframe src="https://your-subdomain.pro-weather.com/embed?size=md"
        width="360" height="172"
        style="border:0;max-width:100%" loading="lazy"
        title="Live weather"></iframe>

It refreshes itself about every five minutes, so a page that stays open keeps showing current readings. It uses no cookies and loads no third-party scripts.

Three sizes are available: sm (300x148), md (360x172) and lg (480x218). The larger the widget, the more readings it shows - two, four or six, chosen from humidity, wind, rain today, pressure, gust and dew point. Whatever your station does not measure is left out rather than shown as blank.

The badge image

<a href="https://your-subdomain.pro-weather.com" target="_blank" rel="noopener">
  <img src="https://pro-weather.com/api/v1/your-subdomain/badge.svg?size=card"
       alt="Live weather" width="340" height="92">
</a>

Two sizes: card (340x92) with the temperature and three readings, and pill (300x28), a single line that fits a signature.

A badge is an ordinary image, so it cannot refresh itself - it updates when the page around it is reloaded. It is an SVG, which stays sharp on any screen. A few older forums put images through a proxy that rejects SVG; if yours shows a broken image, tell us and we will add a PNG version.

Options

Add these to either URL. Anything you leave out follows your own site's setting, and anything unrecognised falls back to it too - a widget never shows an error on somebody else's page.

theme=auto follows the visitor's own light or dark setting, which is usually what you want on a page you do not control. The badge is an image and cannot detect that, so it uses light unless you ask for dark.

units and lang are for the audience of the page you are embedding into, not for you. A Belgian club embedding a Texan station can show it in Celsius and Dutch without the station owner changing anything.

Which address to use

The dashboard gives you your-subdomain.pro-weather.com by default, even if you have a custom domain. That is deliberate: your subdomain always works, while a custom domain can be moved or removed later - and a broken widget lives on a page you may no longer be able to edit. There is a checkbox to use your custom domain if you prefer it.

Notes

• The widget and badge show only what your public page already shows. They are not affected by the "Public data API and RSS feed" switch in Settings, which covers the JSON API and RSS feed.
• If your site is not published yet, the widget shows "coming soon".
• If your plan lapses, the widget goes quiet in the same way your site does, and comes back when the plan does.
• Readings older than 30 minutes are shown dimmed with the time highlighted, so a station that has gone offline looks offline rather than wrong.