Clicking marker shows popup with listing name, category, and detail link
Why it matters
Markers without popups force users to guess what each pin represents or drill into a separate detail page just to identify a listing, crushing map-to-detail conversion and making the directory feel broken. Users abandon flows when a tapped marker does nothing, silently loses context, or reveals only an opaque listing ID. Missing name, category, or detail link on click also breaks WCAG 2.2 SC 2.4.4 (Link Purpose) because users cannot discern where the interaction leads without surrounding context.
Severity rationale
High because non-interactive markers collapse the directory's primary browse-to-detail path and strand every map visitor.
Remediation
Attach a click handler to each marker that opens a popup containing the listing name, category or type, and a link to the detail route. Use the map library's built-in popup primitive so focus, escape-to-close, and outside-click dismissal are handled for you. Example with Mapbox GL:
new mapboxgl.Marker()
.setLngLat([listing.lng, listing.lat])
.setPopup(new mapboxgl.Popup({ offset: 25 }).setHTML(
`<h3>${listing.name}</h3><p>${listing.category}</p><a href="/listings/${listing.id}">View details</a>`
))
.addTo(map);
DetectionPro
The detection method for this pattern is part of AuditBuffet Pro.
The full method (what to look for, pass and fail conditions, and how results get reported) ships inside the Map & Location Integration Audit. The pattern definition, severity rationale, and remediation remain openly licensed under CC-BY-4.0.
External references
- wcag:2.2 · 2.4.4 — Link Purpose (In Context)
Taxons
History
- 2026-04-18·v1.0.0·Initial import from directory-map-location·automated