Storymaps
A storymap tells a story in steps beside a map. The map stays in view while the reader scrolls, and moves to each step as it comes up: to a place, to the part of a journey the step is about, or to the layers it explains. The steps are ordinary Markdown, so the story still reads as a page without the map.
Docked
The steps beside the map, in a page like any other. A storymap is docked unless it says otherwise.
Floating
The map fills the storymap, and the steps scroll over it as cards.
A story page
A page of its own, where the map fills the window.
- 1The steps are ordinary Markdown. The one the reader has scrolled to is the active step.
- 2The map stays in view, and moves to what the active step is about.
See one
- A saildrone in the Pacific follows a NOAA sailing drone for five months on a globe. Its track draws itself as you scroll, a marker sails at its head, and the sixth step colours it by the temperature of the sea.
- The Postdoc story has no map at all: a picture stays in view for each step, beside the commands you'd run.
Write one
- Your first storymap goes from an empty page to a map that flies between three harbours, in four short steps.
- Story pages puts a story on a page of its own, where the map fills the window.
- Mapping a mission is for people who work with geospatial data. It builds the saildrone story from a public dataset: tiles, time, data-driven colours, a legend and a readout under the pointer.
- The reference lists every attribute and setting.
What a storymap can do
| It has | What that means |
|---|---|
| Views | A place and a zoom, or an area to fit. The map can turn and tilt, and each move can take as long as the story needs. |
| Time | Layers that hold a time show up to the moment a step has reached, so a track grows from step to step, with a marker at its head. |
| Layers | A step shows or hides layers. Their colours can follow the data, with a legend that appears when they do. |
| Readouts | Point at a feature to read its properties. |
| Base maps | Any MapLibre style: vector or raster tiles, a WMS, or a single PMTiles file, on a flat map or a globe. |
| Pictures | A picture for each step instead of a map, with no map code loaded. |
| Layouts | Docked beside the text of a page, floating over a map that fills the storymap, or on a page of its own. |
For every reader
- The steps are the story. Without JavaScript or WebGL, or with a screen reader, they read as an ordinary page.
- The map is named after the step it shows. Its zoom buttons and the arrow keys work with the keyboard.
- Scrolling the page doesn't zoom the map. That takes Ctrl and the scroll wheel, or two fingers.
- With reduced motion turned on, the map jumps to each step instead of flying there, the timeline shows each step's time at once, and pictures change without fading.
- What a readout or a legend shows is extra. Say what matters in the step as well.
The map is drawn with MapLibre, which Postdoc loads, with PMTiles when a source needs it, only on pages that have a storymap with a map.