Leaflet map
A free, open-source alternative to Google Maps using Leaflet.js. No API key required.
Overview
The Leaflet Map element provides all the functionality of Woohoo Google Map without requiring a Google Maps API key. Uses OpenStreetMap tiles by default with multiple tile provider options.
Content Settings
Locations:
Location Source
Manual, Dynamic, or Dynamic-sync
Location Items
Repeater for manual locations (lat, lng, address, popup content)
Post Type
For dynamic mode
Posts Limit
Maximum posts to display
Latitude/Longitude Fields
ACF or meta field names
Address Field
For geocoding fallback
Custom Marker
Per-location marker image
Query Name
For dynamic-sync mode
Clustering:
Enable Clustering
Group nearby markers
Cluster Radius
Pixels to group markers (default: 80)
Medium Threshold
Point count for medium cluster
Large Threshold
Point count for large cluster
Map Settings:
Map Style
Multiple tile providers (default, CartoDB, Stamen, etc.)
Center Latitude/Longitude
Initial map center
Zoom
Initial zoom level (0-19)
Fit All Markers
Auto-fit bounds to show all markers
Bounds Padding
Padding around fitted bounds
Max Zoom (fit bounds)
Prevent over-zooming when fitting
Fit Bounds on Update
Re-fit when markers change
Zoom Control
Show +/- buttons
Scroll Wheel Zoom
Enable mouse wheel zooming
Popup Settings:
Show Close Button
Display X on popups
Auto-pan to Popup
Pan map to show full popup
Design Settings
Map size (width, height)
Custom markers (image, active state, dimensions)
Clustering colors (small, medium, large, text)
Popup styling (width, background, borders, padding, typography)
Spacing
Tile Providers
Multiple built-in map styles available:
OpenStreetMap (default)
CartoDB Positron (light)
CartoDB Dark Matter
Stamen Terrain
Stamen Watercolor
And more...
Key Differences from Google Map
API Key Required
Yes
No
Cost
Paid after free tier
Free
Tile Provider
OpenStreetMap + others
Geocoding
Not built-in
Street View
Yes
No
Implementation
Last updated