Title: Out of the Block: OpenStreetMap
Author: Giorgos Sarigiannidis
Published: 15 Sebteembar, 2020
Last modified: 29 Maarso, 2026
---
Raadi kaabayaal
# Out of the Block: OpenStreetMap
Qore [Giorgos Sarigiannidis](https://profiles.wordpress.org/gsarig/)
[Soo Rog](https://downloads.wordpress.org/plugin/ootb-openstreetmap.2.12.0.zip)
* [Faahfaahin](https://so.wordpress.org/plugins/ootb-openstreetmap/#description)
* [Dibu-eegisyo](https://so.wordpress.org/plugins/ootb-openstreetmap/#reviews)
* [Rakibaad](https://so.wordpress.org/plugins/ootb-openstreetmap/#installation)
* [Horumarinta](https://so.wordpress.org/plugins/ootb-openstreetmap/#developers)
[Taageero](https://wordpress.org/support/plugin/ootb-openstreetmap/)
## Sharraxaad
A map block for Gutenberg which uses [OpenStreetMap](https://www.openstreetmap.org)
and [Leaflet.js](https://leafletjs.com). It needs no API keys and works out of the
box (or, out of the Block, if you prefer). Benefiting from Gutenberg’s potential,
the plugin tries a different take on how to add your locations on the map and rethinks
a few things, UX-wise.
Instead of manually adding coordinates for each one of your markers, just click-
and-drop them directly on the map. You want to adjust their position? Just drag
them wherever you want. And instead of filling-in custom fields to set each marker’s
popup content, just open that popup and start writing in it, the Gutenberg way (
it supports WYSIWYG editing, with links, images, and all). It even stores the map’s
zoom level as you use it so that you don’t have to set it by hand.
* [Follow the project’s development on GitHub](https://github.com/gsarig/ootb-openstreetmap)
* [Release history](https://github.com/gsarig/ootb-openstreetmap/releases)
* [Roadmap](https://github.com/users/gsarig/projects/1)
* [Hooks🪝](https://github.com/gsarig/ootb-openstreetmap?tab=readme-ov-file#hooks)
* [Shortcodes](https://github.com/gsarig/ootb-openstreetmap?tab=readme-ov-file#shortcodes)
#### Features
* No need for API keys. Just install and use it.
* Support for multiple markers.
* Support for a different icon per marker.
* Support for polygons and polylines.
* Marker clustering: group nearby markers into clusters that expand as you zoom
in.
* [Dead-simple interface](https://www.gsarigiannidis.gr/wordpress-gutenberg-map-block-openstreetmap/).
Don’t search for coordinates and don’t get overwhelmed by too many fields when
using multiple markers. Just point and click on the map to add your marker where
you want it and edit it’s popup content directly from there.
* [Place search](https://www.gsarigiannidis.gr/openstreetmap-place-search/). Find
locations by typing keywords.
* Remembers the zoom that you set when adding the markers and stores it so that
you don’t set it by hand (which you can do anyway if you prefer).
* AI integration which allows you to add markers by using commands in natural language.
Just say “please” to activate (e.g. “Please, show me where GOT was filmed”).
Requires an API key from an AI Provider, or a site-level AI connector on WordPress
7.0+. [Read more](https://www.gsarigiannidis.gr/openstreetmap-openai-integration/).
* Query Maps: Supports creating a map out of maps added on other posts or post
types. This can be quite powerful when, for example, you have a custom post type
for “Places” with each place having its own map, and you want to dynamically
gather-up all the places on a single map.
* Shortcode support: You can use the shortcode `[ootb_query]` as an alternative
way to use the aforementioned Query Maps feature (see the FAQ for more info).
* Support for a location custom field, which can be used to store a post’s or post
type’s location, following the [Geodata guidelines](https://codex.wordpress.org/Geodata).
Read more in the [v.2.8.0 release notes](https://github.com/gsarig/ootb-openstreetmap/releases/tag/2.8.0).
* Adjust the map height.
* Change the default marker icon with a custom one.
* Enable or disable map dragging.
* Enable or disable touch zoom.
* Enable or disable double-click zoom.
* Enable or disable scroll wheel zoom.
* Set a minimum and maximum limit that the user can zoom on the frontend. Setting
the same value to both fields will lock the zoom at that level.
* Support for other Layer Providers: MapBox (using your own API key) and Stamen.
* Option to export locations in a JSON file
* Option to import locations from a JSON file
## Sawir-shaashado
* [[
* Adding markers and rich content
* [[
* Using the place search to throw multiple markers in a row by typing keyword and
double+enter (no mouse)
* [[
* The map editing screen
* [[
* Map behavior options
* [[
* Adding a marker
* [[
* Using custom markers
* [[
* Place search
* [[
* Plugin settings page
* [[
* Adding a polygon
* [[
* Adding a polyline
* [[
* Export and import locations
* [[
* Demonstrating the OpenAI integration
* [[
* Marker clustering
## Xayndaabyo
Kaabahani wuxuu bixinaya 1 xayndaab.
* OpenStreetMap by Out of the Block A map block for the Gutenberg Editor using
OpenStreetMaps and Leaflet that needs no API keys and works out of the box.
## Rakibaad
1. Upload the plugin to your WordPress plugins directory and activate it.
2. That’s it. You can go to a post/page that supports the Gutenberg editor and start
using the block called “Out of the Block: OpenStreetMap”
## SBI
### Do I need an API key, like with Google Maps?
No.
That’s the point, actually. Just install the plugin and start adding maps. Keep
in mind, though, that as stated on the [OpenStreetMap Tile Usage Policy](https://operations.osmfoundation.org/policies/tiles/),
OSM’s own servers are run entirely on donated resources and they have strictly limited
capacity. Using them on a site with low traffic will probably be fine. Nevertheless,
you are advised to create an account to [MapBox](https://www.mapbox.com/) and get
a free API Key.
### How can I add a custom Mapbox style?
You can find the style URL on [Mapbox Studio](https://www.mapbox.com/studio/). There,
use the “Share” button, and under “Developer resources”, copy the “Style URL”. It
should look like that: `mapbox://styles/username/style-id`. You can declare a global
style on the plugin’s settings, to be used as a default for all the maps, or you
can set a custom style for each map, by using the block’s settings panel.
### How do I add a new location?
To add a location, left-click on the map for a while, until you see the prompt saying“
Release to drop a marker here”. On browsers that support it, the cursor transforms
from hand to crosshair, to make it even more apparent. As long as the prompt is
visible, it means that releasing the click will drop the marker at that spot. That
slight delay has been added to prevent you from accidentally adding markers all
over the place with every click.
Alternatively, you can use the map’s place search functionality.
### How do I remove a location?
Click on the marker to open up its popup. There, you will see the “Remove” button.
### I can’t find some of the options like disable dragging, setting zoom levels etc
Check under the “Map behavior” section, at the blocks’ settings at the sidebar on
the right. It’s toggled off by default, that’s probably why you missed it.
### How does the AI integration work?
First of all, you will need to create an account to an AI provider (like [OpenAI](https://openai.com/),
[Gemini](https://gemini.google.com/), [Anthropic](https://console.anthropic.com/)
or similar) and get an API key. Then, go to the plugin’s settings page and paste
your API provider’s endpoint URL, Model and API key there. After that, you can start
adding markers by using commands in natural language. Just say “please” to activate(
e.g. “Please, show me where GOT was filmed”). Please keep in mind, though, that
it’s like asking ChatGPT, Claude or any other AI Assistant: the answers you get
might not always be 100% reliable, and you should always double-check to confirm
their accuracy. [Read more](https://www.gsarigiannidis.gr/openstreetmap-openai-integration/).
If you are running WordPress 7.0 or later and a site-level AI connector is configured
at Settings Connectors, you can skip the above. The plugin will use the connector
automatically, with no API key required on your part.
### How can I query maps from other posts or post types?
On the block’s side panel, Select the “Map data” panel and click on the “Fetch locations”
button. This will automatically retrieve on the frontend all the markers from your
posts (you can also select a specific post type from the dropdown). The block will
be locked from editing, as the markers will be dynamically retrieved from the selected
posts. If you don’t want that, there is a “Stop syncing” button that will unlock
the block, drop the markers on the map and allow you to edit.
### How can I use the shortcode?
To see the available shortcodes and the parameters that you can pass, [go here](https://github.com/gsarig/ootb-openstreetmap?tab=readme-ov-file#shortcodes).
### I want more control. Are there any hooks that I could use?
Glad you asked! There are a few hooks that you can use to further customize the
plugin’s behavior. [You can find them here](https://github.com/gsarig/ootb-openstreetmap?tab=readme-ov-file#hooks).
## Dibu-eegisyo
### [Loved it!](https://wordpress.org/support/topic/loved-it-192/)
[Amadeu Arderiu](https://profiles.wordpress.org/amadeuarderiu/) 21 Maarso, 2025
In 5 minutes I had a map with a marker. Easy!
### [Great plugin](https://wordpress.org/support/topic/great-plugin-40300/)
[Wesley M. Dekker BBA](https://profiles.wordpress.org/wmdekker/) 19 Maarso, 2025
The plugin is easy to set up and use. Had some difficulty to get the map showing,
but it was quickly resolved.
### [Great and Easy](https://wordpress.org/support/topic/great-and-easy-143/)
[sebastian](https://profiles.wordpress.org/schertel/) 7 Abriil, 2023
This is one hell of a nice plugin. It allows you to easily put a block on your site
and add (multiple) markers. You can easily change the contents of the popup (just
don’t go wild) and is GDPR friendly. If that’s what you need this is the plugin
to go to. If you need other stuff (e. g. filters and stuff) – keep looking. But
for a simple map that just works and has a easy, clean interface take this one.
### [Very nice – but only for Gutenberg](https://wordpress.org/support/topic/very-nice-but-only-for-gutenberg/)
[Hoerli](https://profiles.wordpress.org/hoerli/) 4 Maajo, 2023
The plugin is really great.
Too bad it only works with the Gutenberg editor.
I prefer to use the Classic Editor, but there I can not use the plugin so.
I would have to adjust the HTML source code by hand.
The Map is not
loading, if CloudFlare Rocket Loader is active.
### [Simple to use](https://wordpress.org/support/topic/simple-to-use-274/)
[rol69](https://profiles.wordpress.org/rol69/) 11 Maajo, 2021
I have testet a lot of OSM plugins. I only needed a card with two markers. This
plugin is simple. In a few minutes the card is ready.
### [Who needs Google maps?](https://wordpress.org/support/topic/who-needs-google-maps/)
[AlfredG](https://profiles.wordpress.org/alfredg/) 6 Oktoobar, 2020
Great plugin. First one that works very easy with multiple pins. And no API en giving
credentials for billing. In the info window you van make a link to the route on
Google maps if you want. Formatting the block is easy.
[ Akhri dhammaan 7 dibu-eegis ](https://wordpress.org/support/plugin/ootb-openstreetmap/reviews/)
## Ka-qaybgalayaasha & Horumariyayaasha
“Out of the Block: OpenStreetMap” waa softiweer il furan. Dadka soo socda ayaa wax
ku biiriyay kaabahan.
Ka-qaybgalayaasha
* [ Giorgos Sarigiannidis ](https://profiles.wordpress.org/gsarig/)
“Out of the Block: OpenStreetMap” waxaa lagu tarjumay 2 luqadood. Way ku mahadsan
yihiin [turjumaannada](https://translate.wordpress.org/projects/wp-plugins/ootb-openstreetmap/contributors)
ka-qaybqaadashadooda.
[Ku tarjun “Out of the Block: OpenStreetMap” luqaddaada.](https://translate.wordpress.org/projects/wp-plugins/ootb-openstreetmap)
### Ma xiisaynaysaa horumarinta?
[Baadh koodka](https://plugins.trac.wordpress.org/browser/ootb-openstreetmap/),
fiiri [bakhaarka SVN](https://plugins.svn.wordpress.org/ootb-openstreetmap/), ama
iska qor [diiwaanka horumarinta](https://plugins.trac.wordpress.org/log/ootb-openstreetmap/)
adigoo adeegsanaya [RSS](https://plugins.trac.wordpress.org/log/ootb-openstreetmap/?limit=100&mode=stop_on_copy&format=rss).
## Isbeddellada
#### 2.12.0
* Adds WordPress 7.0 compatibility.
* Adds WordPress AI Client integration for smarter location search.
* Adds WordPress Playground blueprint for quick demos.
* Fixes JS error handling, race condition, and edge cases.
* Hardens OpenAI REST endpoint validation and error handling.
* Dependency updates.
#### 2.11.0
* Adds marker clustering support.
* Extends the AI ability with additional map display and behavior parameters (map
type, zoom range, interaction controls, shape options).
* Adds integration tests for all public Query filter hooks.
* Dependency updates: @wordpress/scripts, @playwright/test, and GitHub Actions.
#### 2.10.0
* Added fullscreen support for the map block.
* Geodata map markers now show the post title (and thumbnail if available) as default
popup content when no address or custom filter content is provided.
#### 2.9.0
* Adds support for the WordPress Abilities API.
* Bumps minimum supported WordPress version to 6.6.
* Fixes a bug where empty markers could cause an error.
#### 2.8.9
* Fixes a bug where the block alignment wasn’t respected.
* Build script updates.
* Ensures compatibility with WordPress 6.9.
#### 2.8.8
* Added filter hook `ootb_block_marker_text` to allow customization of marker popup
content
* Build script updates
#### 2.8.7
* Fixes a bug where the popup wasn’t editable with WordPress 6.8
#### 2.8.6
Adds support for more AI Providers, besides OpenAI (OpenAI is kept as the default).
#### 2.8.5
* Various fixes to ensure that it passes the checks of the “Plugin Check” plugin.
* Drops support for legacy PHP versions. The minimum requirement is PHP 8.1.
#### 2.8.4
* Security update. Fixes a vulnerability which allows authenticated attackers with
contributor permissions or above to insert JavaScript that triggers when accessing
the web-page by mouse.
#### 2.8.3
* Bumps support to WordPress 6.7.
* Bumps minimum supported WordPress version to 6.5.
* Fixes a tagging issue in the wordpress.org repo.
* Partially fixes a bug where the block wouldn’t display on the Full Site Editor’s
template parts. There is still a bug where dragging doesn’t work well when the
block is used in a template part, and was disabled as a temporary workaround.
* Improves the way the frontend scripts are loaded (requires at least WordPress
v.6.5 amd above).
#### 2.8.2
* [NEW] Adds the `ootb_cf_modal_content` and `ootb_cf_marker_icon` hooks, which
allow you to change the content of the modal that appears when you query posts
based on their “Location” custom fields, as well as the marker icon. For more
info, check the plugin’s FAQ section.
#### 2.8.0
* [NEW] Adds an option to enable a location custom field, which can be used to
store a post’s or post type’s location, following the [Geodata guidelines](https://codex.wordpress.org/Geodata).
* [NEW] Adds a new block (a Block Variation, to be precise), to display a map that
retrieves markers from posts or post types including the location custom field.
* [FIX] Fixes a PHP warning ([see the report](https://wordpress.org/support/topic/automatic-conversion-of-false-to-array-is-deprecated-php-8-1-warning/)).
* [FIX] Fixes a bug which caused an editor crash ([see the report](https://wordpress.org/support/topic/js-error-editor-crash-when-swapping-a-template/)).
* [FIX] Fixes an issue where the plugin was triggering unnecessary post updates.
* [MAINTENANCE] Updates the build scripts and the plugin’s assets.
#### 2.7.0
* [NEW] Adds an option to set custom Mapbox styles using [Mapbox Studio](https://www.mapbox.com/studio/).
#### 2.6.0
* [NEW] Adds option to query maps, which allows you to create a map out of maps
added on other posts or post types. This can be quite powerful when, for example,
you have a custom post type for “Places” with each place having its own map,
and you want to dynamically gather-up all the places on a single map.
* [NEW] Adds shortcode support. You can use the shortcode `[ootb_query]` to retrieve
the aforementioned Query Maps feature (see the FAQ for more info).
#### 2.5.0
* [New] Adds OpenAI integration which allows you to add markers by using commands
in natural language. Just say “please” to activate (e.g. “Please, show me where
GOT was filmed”). Requires an OpenAI API key. [Read more](https://www.gsarigiannidis.gr/openstreetmap-openai-integration/).
#### 2.4.1
* Updates the build scripts.
* Updates compatibility with WordPress 6.4.
* Fixes a bug where the marker’s delete button would remove the wrong marker.
#### 2.4.0
* [New] Adds an option to prevent the default map scroll/touch behaviours.
#### 2.3.0
* [New] Adds support for different icons per marker.
* Updates the `react-leaflet` script to `v.4.2.1`.
* Updates compatibility with WordPress 6.2.
#### 2.2.0
* [New] Adds option to export locations to a JSON file
* [New] Adds option to import locations from a previously exported JSON file
#### 2.1.0
* [New] Adds support for polygon shapes
* [New] Adds support for polyline shapes
* [Fix] Improves the drag and drop of markers
* Updates the `react-leaflet` script to `v.4.2.0`
* Updates the plugin’s assets and documentation
#### 2.0.2
* Replaces `str_contains` with `strpos`, for better backwards compatibility with
older versions of PHP / WordPress.
#### 2.0.1
* Fixes a bug which broke the admin on WordPress versions prior to 5.9.
#### 2.0.0
* Refactors the build scripts to use the official `@wordpress/create-block` instead
of `create-guten-block`, which isn’t supported anymore.
* Updates `Leaflet` and `react-leaflet` to their latest versions (Leaflet 1.9.3
and react-leaflet 4.1.0).
* Adds a new option to set the default coordinates when you add a new block. The
plugin will try to guess the default location based on the site’s timezone.
#### 1.3.5
* Fixes a PHP warning in the widgets area of the admin
* Updates translations
#### 1.3.4
* Fixes a PHP warning (more info: https://wordpress.org/support/topic/error-under-
php8-2/)
#### 1.3.3
* Fixes a bug where the block’s scripts didn’t load if the block is used in a Widget
#### 1.3.2
* Fixes a bug where the block’s scripts didn’t load when used as a reusable block
#### 1.3
* Added Stamen as a Tile Provider
* Fixed a bug with map centering when there is only one location
* Fixed wrong link on attributions
#### 1.2
* Added MapBox as a Tile Provider
#### 1.1
* Place search functionality added
* Improved marker precision
* Better handling of pinning on mobile devices
* Overall improvements on dragging smoothness
#### 1.0.1
* Fixed a bug during plugin activation.
#### 1.0
* First releases
## Meta
* Version **2.12.0**
* Last updated **2 todobaad kahor**
* Active installations **800+**
* WordPress version ** 6.6 ama ka sareeya **
* Tested up to **7.0**
* PHP version ** 8.1 ama ka sareeya **
* Languages
* [Dutch](https://nl.wordpress.org/plugins/ootb-openstreetmap/), [English (US)](https://wordpress.org/plugins/ootb-openstreetmap/),
and [French (France)](https://fr.wordpress.org/plugins/ootb-openstreetmap/).
* [Ku tarjun luqaddaada](https://translate.wordpress.org/projects/wp-plugins/ootb-openstreetmap)
* Tags
* [block](https://so.wordpress.org/plugins/tags/block/)[Google Maps](https://so.wordpress.org/plugins/tags/google-maps/)
[leaflet](https://so.wordpress.org/plugins/tags/leaflet/)[map](https://so.wordpress.org/plugins/tags/map/)
[openstreetmap](https://so.wordpress.org/plugins/tags/openstreetmap/)
* [Aragti Sare](https://so.wordpress.org/plugins/ootb-openstreetmap/advanced/)
## Qiimeynta
4.9 out of 5 stars.
* [ 6 5-star reviews ](https://wordpress.org/support/plugin/ootb-openstreetmap/reviews/?filter=5)
* [ 1 4-star review ](https://wordpress.org/support/plugin/ootb-openstreetmap/reviews/?filter=4)
* [ 0 3-star reviews ](https://wordpress.org/support/plugin/ootb-openstreetmap/reviews/?filter=3)
* [ 0 2-star reviews ](https://wordpress.org/support/plugin/ootb-openstreetmap/reviews/?filter=2)
* [ 0 1-star reviews ](https://wordpress.org/support/plugin/ootb-openstreetmap/reviews/?filter=1)
[Your review](https://wordpress.org/support/plugin/ootb-openstreetmap/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/ootb-openstreetmap/reviews/)
## Ka-qaybgalayaasha
* [ Giorgos Sarigiannidis ](https://profiles.wordpress.org/gsarig/)
## Taageero
Dhibaatooyinka la xaliyay labadii bilood ee la soo dhaafay:
1 ee 2
[Eeg madasha taageerada](https://wordpress.org/support/plugin/ootb-openstreetmap/)
## Ku deeq
Ma jeclaan lahayd inaad taageerto horumarinta kaabahan?
[ Ugu deeq kaabahan ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=MZR4JSRUMH5EA&source=url)