| Summary | A Discourse plugin that adds structured and geocoded topic and user locations with map-based discovery | |
| Repository Link | https://github.com/merefield/discourse-locations | |
| Install Guide | How to install plugins in Discourse | |
| Sponsorship | Please consider becoming an ongoing sponsor of my open source work at a level that suits your or your organisation’s resources and needs to ensure this plugin gets the maintenance it deserves and continues to work for your site in the future. |
Enjoying this plugin? Please
it on GitHub! ![]()
Features
Discourse Locations provides the complete location-storage, geocoding, and map foundation. The optional Pro extension adds advanced discovery, automation, and users-map presentation while requiring this base plugin.
| Feature | Base plugin | Pro extension |
|---|---|---|
| Structured topic locations and configurable input fields | — | |
| Optional or required geocoding with multiple providers | — | |
| Category and site-wide topic map views | — | |
| User locations on posts, profiles, cards, and the directory map | — | |
| Leaflet users map with local name and username search | — | |
| Configurable location labels, flags, map markers, clustering, and tiles | — | |
| Default a new topic to the current user’s location | — | |
| Automated IP-based user-location estimation | — | |
| Nearby-topic discovery based on the current user’s location | — | |
| Optional location-aware Discourse Chatbot tools | — | |
| Permission-aware group and result-limit users-map filters | — | |
| Interactive WebGL users-map globe | — | |
| Idle globe screen saver | — |
Installing Pro adds its exclusive features to the base functionality; it does not replace the base plugin.
Configuration
The base plugin’s settings use the location_ prefix and control topic locations, geocoding, map display, user locations, and the standard users map.
Useful documentation:
Privacy and storage
Users choose whether to save a profile location. Complete editable topic and user locations remain in base-owned custom fields, while plugin-owned projection tables support spatial queries and map ordering.
Raw location custom fields are not made globally public. Topic, profile, card, post, and directory responses expose only the location data required by that surface and respect Discourse’s profile and group visibility rules.
Pro extension
Discourse Locations Pro is an optional extension available to GitHub Sponsors as a thank-you for supporting ongoing development. Individual and independent-community sponsors receive access from the $7/month Bronze tier; businesses and institutions must sponsor at the $40/month Silver tier or above. Eligible sponsors receive private-repository installation instructions.
The Pro extension adds automated IP lookup, Nearby topics, Chatbot tools, enhanced users-map filters, the interactive globe, and the globe screen saver. Each optional automation or integration remains disabled until configured, and the Pro master setting can disable all Pro behaviour without disabling the base plugin.
