ClearGauge Logo
ClearGaugeRiver Intelligence
All RiversLive CamerasFree WidgetsArticlesMethodologyAboutContact
Home/Embed Widgets
FREE WEB WIDGETS · NO API KEY REQUIRED

Embed Live River Data on Your Website

Provide your website visitors with live USGS streamflow (CFS), gauge height, and flow verdicts. Designed for fishing guides, rafting outfitters, kayak clubs, and regional tourism boards.

1. Choose Widget Layout
165 Active Stations
ACTIVE SELECTION
Merced River at Pohono Bridge near Yosemite, CA
USGS #11266500 · California
Overrides USGS title
3. Widget Format
7-Day Trend Sparkline Graph
Renders a live flow trend curve with gradient area
4. Theme & Background
Accent Color
5. Card Style
Corner Radius
Card Border
Outline stroke
Shadow
LIVE PREVIEW
Embed FormatWeb Component / JS
✨ Why Script is Recommended:
  • Inherits your website's font: Typography matches your site automatically.
  • Dynamic auto-height: Never gets cut off and never shows double scrollbars.
  • Ultra-lightweight: One shared 2KB script powers every river widget on your page.
HTML & Script Snippet
Works on Webflow, WordPress (Custom HTML), Ghost, Shopify, and custom sites.
Configuration Manual→·White-label?
DOCUMENTATION & MANUALNeed CMS setup steps or attribute docs?

Read our complete guide covering WordPress, Webflow, and Squarespace setup, Script vs. Iframe trade-offs, and full HTML5 customization attributes.

Read Configuration Manual→
PRO & COMMERCIAL INTEGRATIONS

Need White-Labeling or Custom River Corridors?

Looking to remove the ClearGauge attribution badge, match custom typography, display multi-station river corridors on a single dashboard, or request private telemetry feeds for your lodge, guide service, or outfitter?

Contact for Custom Pricing ↗

Automated 15-Min Telemetry

Pulls directly from official USGS hydrological stations every 15 minutes. Zero maintenance required on your end.

Mobile-Responsive & Lightweight

Loads in under 50ms with zero heavy tracking scripts. Fits cleanly into WordPress sidebars, Squarespace, and custom HTML.

100% Free Forever

No subscription, no token limits, and no account signup required. Copy the snippet, paste it into your CMS, and you are done.

Embed & Integration FAQ9 Answers

Frequently Asked Questions - Free River Widgets

Clear answers regarding data privacy, USGS update frequencies, CMS compatibility, and performance.

Do you collect personal data or track visitors who view widgets on my website?

No. ClearGauge widgets do not set cookies, do not collect personal identifying information (PII), do not run third-party advertising networks, and do not track or fingerprint your visitors. To ensure fast edge delivery and prevent malicious traffic or DDoS abuse, our infrastructure only inspects the standard HTTP Referer hostname (e.g., yourdomain.com) to calculate aggregate domain request totals. Your visitors remain 100% anonymous, and your site stays fully compliant with GDPR, CCPA, and global privacy standards.

How often does the live streamflow and gauge height telemetry update?

Streamflow (CFS), gauge height (ft), water temperature, and 6-hour trend deltas refresh automatically in sync with the official USGS National Water Information System (NWIS), typically every 15 to 60 minutes depending on each individual station's satellite transmission cycle. No maintenance, cron jobs, or manual updates are ever needed on your end.

Is the ClearGauge river widget completely free for commercial and guide websites?

Yes, 100% free forever. There are no subscriptions, no monthly fees, no API token limits, and no account registrations required. It is freely available for commercial fishing guides, whitewater rafting outfitters, kayak clubs, watershed associations, regional tourism boards, and personal outdoor blogs.

How do I embed the widget into WordPress, Squarespace, Wix, or Shopify?

Simply copy the generated iframe embed code above and paste it directly into your platform: In WordPress, add a 'Custom HTML' block to any page, post, or sidebar widget area; in Squarespace or Webflow, add an 'Embed' or 'Code' block; in Wix, select Add Elements > Embed Code > Embed HTML. The widget is fully responsive and automatically adapts to your site's column or sidebar width.

Will adding this widget slow down my website or harm Core Web Vitals?

No. ClearGauge widgets load inside an isolated, lightweight HTML iframe with native loading='lazy' support. Because 24-hour trendlines are rendered on the server as pure vector SVG, zero client-side charting libraries (such as Chart.js or D3) or heavy analytics bundles are executed on your site. The total widget bundle is under 15KB and renders in under 50ms with zero Cumulative Layout Shift (CLS).

Should I use the Script Tag or the Universal iframe embed code?

We recommend the Script Tag for most modern websites (WordPress with Custom HTML, Webflow, Ghost, Next.js, and static sites). The script dynamically inherits your website's exact font-family and automatically calculates the card's height so you never experience cutoffs, scrollbars, or layout shifts. Choose the Universal <iframe> if your platform strictly blocks custom JavaScript (such as Wix, free Squarespace, Notion, Substack, or locked corporate CMSs) or when you want an isolated sandbox.

Can I customize the colors, dark mode, and metrics to match my branding?

Yes. The generator gives you full control to switch between Light, Dark, or Transparent background modes, select a custom brand accent hex color, choose corner radius presets (Sharp, Rounded, Default, Pill), toggle card borders and drop shadows, and toggle the 7-day interactive sparkline trendline.

Can I embed multiple river stations in a single widget?

Yes. Select the 'Multi-River Grid' tab in the generator above to choose up to 6 river stations. ClearGauge will generate a single, unified embed code that arranges your stations into an auto-wrapping, responsive grid (1 column on mobile screens, 2 to 3 columns on desktops and tablets).

What happens if a USGS station goes offline or undergoes sensor maintenance?

If a USGS station temporarily stops transmitting or undergoes sensor servicing, the widget continues to display the most recent verified observation alongside an 'Offline / Maintenance' indicator. Once USGS field personnel restore the satellite feed, the widget automatically resumes live updates without requiring any updates to your embed code.

Source: USGS NWIS Real-Time TelemetryRefreshed every 15 minutes
ClearGauge Logo
ClearGauge

Free, plain-English U.S. river conditions for kayakers, anglers, and boaters. Powered by official USGS and NWS data updated every 15 minutes.

Powered by public USGS & NWS data•☕ Support Free Telemetry

Telemetry

  • Live Conditions
  • Live River Webcams
  • Free Embed Widgets
  • Gauge Directory
  • USGS NWIS Stream ↗

Editorial & Guides

  • Educational Guides
  • Flow Methodology
  • Editorial Standards
  • About ClearGauge
  • Contact & Feedback

Legal & Safety

  • Privacy Policy
  • Terms of Service
  • Affiliate Disclosure
  • Safety Disclaimer

© 2026 ClearGauge. All rights reserved. Always verify conditions locally before you go.

OFFICIAL DATA SOURCE: USGS & NOAA