YaMaps for WordPress Plugin


YaMaps plugin is the simplest way to insert Yandex maps on your site. The plugin has a user-friendly interface. You can visually put placemarks on your Yandex map, move them with your mouse, change icons and much more.

For use with the new Gutenberg editor, you need add the classic editor block first!

For the map search to work correctly and find routes, you may need to set an API key (JavaScript API и HTTP Geocoder) on the plugin settings page.

Plugin Highlights:

  • You can add maps to pages without coding.
  • Or you can visually edit the shortcodes in the editor.
  • You can add any number of maps to one page.
  • You can add multiple markers to one card.
  • You can add markers with hyperlinks.
  • You can select the icon and it’s color of the marker in the colorpicker.
  • You can select type of map (Map, Satellite, Hybrid), map zoom, map controls in the visual editor.

Shortcodes Structure

  • yamap center – Map center coordinates
  • yamap height – Map height
  • yamap zoom – Map zoom (0 to 19)
  • yamap scrollzoom – Scrollwheel zoom lock (scrollzoom=“0″ for lock)
  • yamap mobiledrag – Map dragging can be disabled for mobile devices (mobiledrag=“0″ for lock)
  • yamap type – Map type (yandex#map, yandex#satellite, yandex#hybrid)
  • yamap controls – Map controls separated by a semicolon (typeSelector;zoomControl;searchControl;routeEditor;trafficControl;fullscreenControl;geolocationControl)
  • yamap container – ID of the existing block in the WP template. The map will be placed in the block with this ID. The new block in the content will not be created.

  • yaplacemark coord – Placemark coordinates

  • yaplacemark icon – Placemark icon (Yandex.Map icon type or url of your own image)
  • yaplacemark color – Marker color
  • yaplacemark name – Placemark hint or content
  • yaplacemark url – Linked URL or post with ID will be opened by click on the placemark

  • You can insert multiple placemark codes inside the maps’s shortcode.

Shortcode Example

[yamap center=“55.7532,37.6225″ height=“15rem“ zoom=“12″ type=“yandex#map“ controls=“typeSelector;zoomControl“][yaplacemark coord=“55.7532,37.6225″ icon=“islands#blueRailwayIcon“ color=“#ff751f“ name=“Placemark“][/yamap]


  • Visual shortcode dialog window.
  • Shortcode in TinyMCE editor.
  • Map on the blog page.
  • Shortcode button.
  • Visual selecting the marker color.


  1. Upload yamaps folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‚Plugins‘ menu in WordPress.


Do I need a Yandex Map API key for using YaMaps?

At the moment, the key is needed only for the search on the map. The rest of the plugin functionality will work without a key. You can get the key (https://developer.tech.yandex.ru/services/) and enter it in the plugin settings page.

How to choose the type and zoom of the map?

Just set type and zoom of the map in the visual editor window. On the site it will be displayed identically.

How to use the plugin with new Gutenberg editor?

You can add a block with a classic editor and add a map with it. Later, native support can be added if most users start to use Gutenberg.

How to insert a map into my template as PHP code?

Use the tag „echo do_shortcode(“)“ with your map shortcode insde.

How to set an icon that is not in the drop-down list?

You can chose icon at https://tech.yandex.com/maps/doc/jsapi/2.1/ref/reference/option.presetStorage-docpage/ and set it manually to the „Icon“ field. For example „islands#blueRailwayIcon“. Also you can insert the URL of your file in the field. For example, PNG-image with transparency.

Why a can’t change color of StretchyIcon?

This is the limitation of Yandex.Map API. You can select a stretchy icon of the desired color at https://tech.yandex.com/maps/doc/jsapi/2.1/ref/reference/option.presetStorage-docpage/ and set it manually.

Russian description


GitHub Project



30. junija 2024 1 reply
Легкий, простой в использовании, быстрый, без API. Вопрос про возможность добавки HTML, использования сторонних shortcode описания метки типа LightBoxGallery, youtube video ? (Это про Placemark hint or content ?) И есть ли лимит на количество символов описания метки ?
8. apryla 2024 1 reply
Плагин имеет удобный синтаксис, который позволяет быстро добавить сразу множество объектов на карту. Спасибо Юрию за разработку!
19. junija 2022
Снизу карты по середине выводится иконка – копирайт автора плагина. Нет опции для отключения. Убрать, конечно, можно, но о таких вещах лучше предупреждать в документации. Кроме того, это может нарушать соглашение об использовании api карт Яндекса, В итоге воспользовался конструктором карт на сайте Яндекса. А так плагин действительно удобный.
19. maja 2022 1 reply
Здравствуйте! У меня версия YaMaps Версия 0.6.23 И версия WordPress 5.9.3 Почему-то когда только открывается страничка (или обновляется), карты не сразу отображаются, карта появляется только через некоторое время (1-2 минут). Подскажите пожалуйста в чем может быть проблема, и как ее решить?
Read all 39 reviews

Sobustatkujuce a wuwijarje

„YaMaps for WordPress Plugin“ jo software wótwórjonego žrědła. Slědujuce luźe su pśinosowali k toś tomu tykacoju.


“YaMaps for WordPress Plugin” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “YaMaps for WordPress Plugin” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Fixed: Bugfix. Map outside the main WordPress loop caused an error: Invalid API key.


  • Fixed: Bugfix.


  • Fixed: WP 6.0 support


  • Fixed: Bugfix.


  • New: Yandex Map Api is called only for pages with a map.


  • Fixed: Bugfix.


  • Fixed: Adding WP 5.6 support


  • Fixed: HTML validation fix
  • Fixed: Bugfix.


  • Fixed: Adding controls in the editor does not work if the API key is not entered in the plugin settings


  • Edit: If no wp_footer() function is called in the template footer, the map API will be called in an alternative way.


  • Edit: If the Yandex.Maps API key is not set in the plugin settings page, the search field on the map is not displayed.


  • New: Yandex Map Api request and map moved to the footer to speed up content loading.
  • Fixed: Bugfix.


  • Fixed: Bugfix.


  • Fixed: Bugfix.


  • Fixed: Bugfix.


  • Fixed: Bugfix.


  • Fixed: Bugfix for WP 5.3.


  • Fixed: Bugfix.


  • Fixed: Bugfix.


  • New: In the settings page, you can set the Yandex Maps API key if there are problems with limits.
  • Fixed: Bugfix. Display maps in widgets and content same time could cause an error.


  • The button for opening a large yandex map can be switched in the plugin settings.


  • The button for opening a large yandex map was removed.


  • Fixed: Bugfix. Improved compatibility with other plugins.


  • Fixed: Bugfix. In rare cases, the problem of loading the API with custom fields.


  • Fixed: Bugfix. Fixed conflict with Yandex.Metrica
  • New: The plugin works in the Elementor editor.


  • Fixed: Bugfix.


  • Fixed: Bugfix.


  • New: Interaction possibility with the map from other plugins and themes. The possibility of expanding the functionality of the plugin. Contact the author if you need additional features on your website.
  • Code refactoring.
  • Fixed: Bugfix.


  • New: Map dragging can be disabled for mobile devices.
  • Fixed: Bugfix.


  • Fixed: Bugfix.


  • New: You can use your own icons. Place the link to the file in the icon field (url must contain „http“).
  • Fixed: Bugfix.


  • New: Restore defaults button on the settings page.
  • Fixed: Bugfix.


  • Fixed: Incorrect „111“ control in the settings blocked the rendering of elements on new maps.


  • Fixed: Bugfix.


  • Fixed: Bugfix.


  • New: Links-helper for adding controls on the settings page.
  • New: Link to plugin page (It can be disabled in the plugin settings).
  • Fixed: Bugfix.


  • New: Plugin default options page.
  • Fixed: Bugfix.


  • Fixed: Bugfix.


  • New: Adding styles for classic editor block in Gutenberg editor.


  • New: Visual editing of existing maps.
  • New: Nice looking shortcodes template in the TinyMCE editor with edit button.
  • Code refactoring.
  • Fixed: Bugfix.


  • New: „Extra“ Panel tab added
  • New: Instead of the URL, you can put a post ID.
  • New: You can place the map in an existing block in the WordPress template. If filled, the map block in the content will not be created.


  • New: Adding multiple placemarks in the visual editor
  • Change: „routeEditor“ map control replaced with „routeButtonControl“ for a better experience.


  • New: Added map support in WooСommerce product description.


  • Fixed: Bugfix.


  • Fixed: Bugfix.


  • Fixed: Bugfix.


  • Fixed: The way of localization of the plugin is changed. According to the WordPress documentation.


  • New: Added scrollwheel zoom lock


  • Fixed: Adding url tag from a visual editor


  • Fixed: Strip html tags inside shortcode


  • Fixed: Plugin info


  • New: Added icon selection
  • New: Added hyperlinks feature for the icons
  • New: Added „Height“ parameter for map
  • Fixed: Automatically move the marker to the coordinates of the search result


  • Initial release