Add Waterfalls to Your Website

Drop a single <script> tag into any page and get beautiful, auto-updating waterfall cards with photos, live flow data, difficulty badges, and trail stats. Free to use — cards link back to detailed pages on WaterfallHikes.com.

Build Your Embed Code

Live Preview

Click "Load Preview" to see your widget

What's Included

  • High-quality waterfall photos with lazy loading
  • Live flow data from USGS gauges (where available)
  • Difficulty badges — Easy, Moderate, Hard, Drive-Up
  • Trail stats: height, distance, trail type
  • Feature icons: kid-friendly, dog-friendly, swimming, free admission
  • Best-season recommendations
  • Nearest campground info
  • Links back to full waterfall pages on WaterfallHikes.com
  • Responsive grid — looks great on mobile and desktop
  • Self-contained — no external CSS or dependencies needed

Configuration Reference

All configuration is done through data-wh-* attributes on the script tag.

Attribute Type Default Description
data-wh-widget flag — Required. Marks the script tag as a waterfall widget.
data-wh-state string — State name or 2-letter abbreviation. Used alone for state mode, or with data-wh-city for city mode.
data-wh-city string — City name (lowercase, underscores for spaces). Requires data-wh-state.
data-wh-lat float — Latitude for coordinate mode. Requires data-wh-lng.
data-wh-lng float — Longitude for coordinate mode. Requires data-wh-lat.
data-wh-radius integer 30 Search radius in miles (1–100). Applies to city and coordinate modes only.
data-wh-limit integer 6 Number of waterfall cards to show (1–24).

Examples

By State

Show the top waterfalls in Oregon:

<script src="https://waterfallhikes.com/embed/waterfall-widget.js"
  data-wh-widget data-wh-state="OR" data-wh-limit="6"></script>

By City

Show waterfalls within 30 miles of Asheville, NC:

<script src="https://waterfallhikes.com/embed/waterfall-widget.js"
  data-wh-widget data-wh-city="asheville" data-wh-state="NC"
  data-wh-radius="30" data-wh-limit="6"></script>

By Coordinates

Show waterfalls within 25 miles of Yosemite Valley:

<script src="https://waterfallhikes.com/embed/waterfall-widget.js"
  data-wh-widget data-wh-lat="37.75" data-wh-lng="-119.59"
  data-wh-radius="25" data-wh-limit="4"></script>