Embeddable widgets

Put live water-health on your own site

Free embeddable widgets for angling clubs, 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. Bulk / branded embeds for larger commercial partners — email data@rivertruth.uk.

How it works

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>

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.uk so your visitors can dig into evidence.