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]

Screenshot (schermate di esempio)

  • 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



17 Settembre 2020
Приветствую. Добавил 2 карты через acf.. Наблюдаю такой баг обе карты подключаются в одном месте, создаются два элемента ymaps.ymaps-2-1-77-map внутри div.yamap0.Стили инлайновые находятся где надо.
14 Settembre 2020
- вставляется в текстовом редакторе или как шоткод. - есть визуальный редактор, но можно доправить на месте руками - есть настройки "по умолчанию", но можно переписать их в каждом отдельном месте. - точки, координаты и т.п. функции яндекса - все есть, есть выбор, что оставить из элементов управления и что убрать. Единственное, считаю, было бы неплохо добавить ввод координат карты как поле, рядом с полем для координат точек.
12 Agosto 2020
Часто использую этот плагин. Удобно и быстро, ничего лишнего.
18 Maggio 2020
Юрий, столкнулся с проблемой при сохранении настроек в Ymaps вер. 0.6.14 на WordPress 5.4.1 При попытке сохранить настройки (к примеру "Катрту можно перемещать на мобильных устройствах) перебрасывает на /wp-admin/options.php Пробовал удалять, чистить кеш, переустанавливать, ничего не помогает.
1 Maggio 2020
У меня на сайте не хочет отображаться в контактах. API-ключ но не отображается карта вообще
Leggi tutte le recensioni di 24

Contributi e sviluppo

“YaMaps for WordPress Plugin” è un software open source. Le persone che hanno contribuito allo sviluppo di questo plugin sono indicate di seguito.


“YaMaps for WordPress Plugin” è stato tradotto in 1 lingua. Grazie ai traduttori per i loro contributi.

Traduci “YaMaps for WordPress Plugin” nella tua lingua.

Ti interessa lo sviluppo?

Esplora il Codice segui il Repository SVN iscriviti al Log delle Modifiche. Puoi farlo tramite RSS con un lettore di feed.

Changelog (registro delle modifiche)


  • Fixed: HTML validation fix


  • 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