Advanced Map
Show visitors where you are and how to reach each location.
Markers with popups, a searchable location list, style presets, clusters, lines and areas, drawn keylessly from OpenStreetMap or with Google Maps when the site has a key.
Gutenberg block
Requirements
- The block editor (Gutenberg)
- WordPress 6.5 or newer
- PHP 7.4 or newer
- Licence: Pro ($2 / year) — add it to the cart in Moduly
Add it to a page
- Open the page or post in the block editor.
- Click + (Block Inserter) and search for Advanced Map — it is in the Moduly category.
- Insert it, then fill in its content on the canvas. Ready-made presets appear when you insert it, and later under Transform to in the block toolbar.
- Adjust it in the right sidebar: the Block tab holds the settings below, and the Styles tab its colours, typography and spacing.
Settings
General
| Setting | What you can set |
|---|
| Title | List |
| Lat | List |
| Title | Text |
Map
| Setting | What you can set |
|---|
| Drawn with | osm or google |
| Tiles | osm, topo or custom |
| Tile URL (https, with {z} {x} {y}) | Text |
| Attribution | Text |
| Style | Text |
| Google style JSON | Text |
| CSS filter for the tiles | Text |
| Map ID (optional) | Text |
| Map type | roadmap, satellite, hybrid or terrain |
| Centre | fit, first or custom |
| Centre latitude | Text |
| Centre longitude | Text |
| Zoom | 1–20 |
| Zoom on tablets (0 = same) | 0–20 |
| Zoom on phones (0 = same) | 0–20 |
| Height (px) | 160–1200 |
| Height on phones (px, 0 = same) | 0–1200 |
| Corner radius (px) | 0–40 |
Pins and popups
| Setting | What you can set |
|---|
| Pin size (px) | 16–120 |
| Pin | pin, dot or square |
| Group close markers | On / off |
| Group radius (px) | 20–200 |
| Popups open on | click, hover or none |
| Popup width (px) | 160–480 |
| Pins drop in | On / off |
Location list
| Setting | What you can set |
|---|
| List | none, left, right or below |
| Search box | On / off |
| Show addresses | On / off |
| List width (px) | 180–520 |
Lines and areas
| Setting | What you can set |
|---|
| Draw | none, markers, polyline or polygon |
| Line width (px) | 1–20 |
| Dashed | On / off |
Controls
| Setting | What you can set |
|---|
| Pins | Colour |
| Groups | Colour |
| Line | Colour |
| Area fill | Colour |
| Zoom buttons | On / off |
| Mouse wheel zooms (otherwise Ctrl + wheel) | On / off |
| Drag to move | On / off |
| Full screen button | On / off |
| Map type switch | On / off |
| Load when scrolled near | On / off |
Styles tab: spacing, from WordPress's own design tools.
Tips
- Visitors who ask their device for reduced motion get a calmer, still version automatically.
- Not sure where to start? Insert one of its presets and edit from there.
Troubleshooting
- OpenStreetMap's public tile servers have a fair-use policy. Busy sites should use a tile provider (custom tile URL), and the attribution must stay visible.
- Address-only markers call OpenStreetMap Nominatim once from the server (cached forever, at most 3 per render). All demo markers use coordinates.
- The Google Maps browser key is necessarily visible in pages that use Google mode; restrict it to the site's domain.
- A change not showing on the live site is almost always a page cache — clear your caching plugin or host cache.
