Embeddable widgets

Put live water-health on your own site

Free embeddable widgets for rivers trusts, canal trusts, environmental charities, angling and paddle clubs, hire centres, narrowboat charterers, local newsrooms, and community websites. Each widget pulls live Truth Engine data and refreshes every 60 seconds.

All widgets are free for non-commercial and small-commercial use with on-card attribution. For a branded dashboard, bulk member alerts and white-label embeds, see plans for clubs & business.

How it works

Pick a widget below, copy the snippet, and paste it into your CMS. If your site is built by a developer or agency, forward them the snippet — it's a one-line iframe; they'll have it live in a couple of minutes. The technical detail:

Each widget is an iframe pointing to https://rivertruth.co.uk/widget/<scope>/<id>
Default size is 360 × 220, but any aspect works.
Add ?theme=dark for a dark variant; add ?compact=1 for a tighter mini-card.
Refreshes server-side every 60 seconds — no JS framework required on your page.
Open Government Licence — attribution baked into the card.

National live status

Headline overview of England + Wales — active spills, monitors offline, open Truth Engine flags. Good for newsroom dashboards and campaign websites.

Embed code

<iframe
  src="https://rivertruth.co.uk/widget/national"
  width="360"
  height="220"
  loading="lazy"
  title="National live status"
  style="border: 1px solid #d9d2c2; border-radius: 8px;"
></iframe>

Specific river

Live status for a featured river. Useful for angling clubs, hire centres, or local news pages covering one stretch.

Embed code

<iframe
  src="https://rivertruth.co.uk/widget/river/severn"
  width="360"
  height="220"
  loading="lazy"
  title="Specific river"
  style="border: 1px solid #d9d2c2; border-radius: 8px;"
></iframe>

Specific canal

Designed for narrowboat-rental businesses and canal trusts. Same shape as the river widget.

Embed code

<iframe
  src="https://rivertruth.co.uk/widget/canal/grand-union"
  width="360"
  height="220"
  loading="lazy"
  title="Specific canal"
  style="border: 1px solid #d9d2c2; border-radius: 8px;"
></iframe>

Specific water company

All overflows operated by one company. Useful for shareholder transparency dashboards or accountability campaigns.

Embed code

<iframe
  src="https://rivertruth.co.uk/widget/company/thames"
  width="360"
  height="220"
  loading="lazy"
  title="Specific water company"
  style="border: 1px solid #d9d2c2; border-radius: 8px;"
></iframe>

Postcode (5 km radius)

Geocodes a UK postcode and watches every overflow within 5 km. Good for neighbourhood / community websites.

Embed code

<iframe
  src="https://rivertruth.co.uk/widget/postcode/wr1-2nn"
  width="360"
  height="220"
  loading="lazy"
  title="Postcode (5 km radius)"
  style="border: 1px solid #d9d2c2; border-radius: 8px;"
></iframe>

Specific overflow

A single storm overflow's live status — designed for being placed alongside a swim spot or fishing peg.

Embed code

<iframe
  src="https://rivertruth.co.uk/widget/overflow/300"
  width="360"
  height="220"
  loading="lazy"
  title="Specific overflow"
  style="border: 1px solid #d9d2c2; border-radius: 8px;"
></iframe>

Region or association

Aggregates multiple rivers into one card — designed for angling associations, regional conservation groups, and any partner whose patch covers more than one river.

Embed code

<iframe
  src="https://rivertruth.co.uk/widget/region/severn-and-wye"
  width="360"
  height="220"
  loading="lazy"
  title="Region or association"
  style="border: 1px solid #d9d2c2; border-radius: 8px;"
></iframe>

Trust + technical

Frame-ancestors * — widget routes are explicitly framed-anywhere via Content-Security-Policy: frame-ancestors *. The rest of River Truth is frame-ancestors 'none' to prevent clickjacking on the main UI.
No tracking — widgets don't set cookies or run analytics scripts.
Stable URLs — river / canal / company slugs and postcode formats are stable across releases. Overflow IDs are stable for the lifetime of the monitor.
Source disclosure — every widget links back to the full data on rivertruth.co.uk so your visitors can dig into evidence.

If you embed one

Drop us a line at data@rivertruth.co.uk with the URL and we'll feature your site on our credits page. Reciprocal, no strings — and useful for us to know who's using the data so we can prioritise improvements that match real workflows.