Concepts
Layer
A layer is the basic building block for map interactions. Each layer can have its legends, attributions, etc.
JEO supports four layer types out-of-the-box:
Additionally, JEO can generate custom layers using AI (see AI-Generated Map).
Map
A map is composed of one or more layers and can be associated with related geolocated posts, that'll be rendered as markers on the map.
A map post is used for reusable map interactions, that can be embedded in any post as a shortcode or Gutenberg block.
One-time Map
Instead of creating a reusable map any time you want to add a map interaction, you can create and configure an inline single-use map via the One-Time Map block for Gutenberg.
Geolocating Posts
Posts can be geolocated manually by searching and adding points in the Geolocation sidebar, or automatically using AI georeferencing — which analyzes the post content and suggests locations with confidence scores. See Geolocating posts and AI Georeferencing.
AI Features
JEO's AI features are powered by a configurable external AI provider with a built-in knowledge base (RAG), specialized agents, and structured output. See AI in JEO for a detailed explanation of how these pieces work together.
AI-Generated Map
An AI-assisted map block that generates contextual maps from a text prompt or post content, with a chat interface for refinement. It can also generate custom map layers when a Mapbox key is configured. See Minimap.
Story Map
A Story Map is a scrollytelling experience: each slide has a location, layers, and text. As the reader scrolls, the map transitions between slides. See Story Map.
Discovery
A full-page interactive map where readers can explore geolocated stories, toggle layers from different maps, and share a customized view. See Discovery.
Stories Near You
A block that displays geolocated posts closest to the reader's location, with consent-based browser geolocation and automatic fallback. See Stories Near You.