Mobile Map Widget


Mobile Map Widget is meant for websites that target browsing via mobile devices. This widget adds a mobile-optimised Static Google Maps Image with a colored pin centered on your destination. Once clicked it opens the Google mobile maps website where you can fill in your Current Location if it is not already there. Then you can see the directions from your location to the destination as well as the map with the route of your choice. Optimised for mobile use. Google Static Maps API-key is required.

The reason we developed the Mobile Map Widget as a plugin, is because while implementing the widget for a mobile framework we were building for the hospitality industry, we realised that this widget can come in handy for many other scenarios too. It can for example be added to a company website to help people find the office location from wherever in the city they are. A travel information site can use it to include maps of tourist attractions, bars and restaurants can use it, you can use it to direct people to your new home, it can even come in handy for if you organise a party with a location that is kept secret till the very last moment!

Once activated you can go to your Widgets (in the backend under Appearance or via the Customizer) and drag the Mobile Map Widget to the sidebar of your choice. When you have placed the widget in a sidebar you need to fill in the following data:

  1. Title (optional).

  2. Destination. Use an address or use the coordinates. The map will also be automatically centered on this location.

  3. Color of the pin. You can choose from black, brown, green, purple, yellow, blue, gray, orange, red, white.

  4. Zoom level. From 0 (world view) to 21+ (street view); from 15 and up seems to be good for locations in larger cities, but best to check and play around with it a bit.

  5. Width in pixels. The image width will be automatically scaled to optimise for mobile screens.

  6. Height in pixels.

  7. Google Static Maps API Key (REQUIRED). Since July 16, 2018 a valid credit card is required by Google to sign up for the API-key

  8. Description (optional). You can use this field to add a description under the map image, for example to inform your visitors that the image is clickable.

Save the widget and check the frontend of the site to see the map image.

We support this plugin through Github. Therefore, if you have any questions, need help and/or want to make a feature request, please open an issue over at Github. You can also browse through open and closed issues to find what you are looking for and perhaps even help others.

If you like the Mobile Map Widget plugin, please consider leaving a review or making a donation. Thanks!

Mobile Map Widget plugin by SO WP


  • Widget Settings in the WordPress backend
  • The widget showing the Google Static Maps Image of your destination



Search for “mobile map widget” and install with the Plugins > Add New back-end page.

… OR …

Follow these steps:

  1. Download zip file.

  2. Upload the zip file via the Plugins > Add New > Upload page … OR … unpack and upload with your favourite FTP client to the /plugins/ folder.

  3. Activate the plugin on the Plugins page.



Where is the settings page?

You can adjust all the necessary settings in the widget itself.

A few settings are done by default: the scale of the image is set to 2, to optimise it for mobile resolutions and the link opens in a new tab; if I get complaints about the latter I will make it optional.

Please note that the zoom, width and height parameters take a numerical value only.

After adding the widget, why does it show some place in the middle of the North Atlantic Ocean?

The widget takes default settings, so what better location to choose than the very spot we operate from? Just replace the default setting with the address (or the coordinates) of the location you wish to add. The same goes for the other default values of the widget.

Do I need a Google Static Maps API-key?

The Google Static Maps API-key is mandatory, get it at Google Map APIs. Since July 16, 2018 a valid credit card is required by Google to sign up for the API-key

Nothing shows on the frontend

Did you enter a valid Google Static Maps API-key? Since July 16, 2018 a valid credit card is required by Google to sign up for the API-key Make sure to go through all the settings, because to be honest Google is not making it very easy to add the key and validate it properly…

Where can I sign up for the Google Static Maps API-key?

See above.

I cannot display a map larger than 640 x 640 pixels

That is a limit Google has put on the use of Static Maps images:

Static Maps images can be returned in any size up to 640 x 640 pixels.

When I use the Customizer to add the Mobile Map Widget I am seeing a lot of PHP Notices or nothing at all. What’s wrong?

This only happens if you have not yet added the Google Static Maps API Key. You will need to generate a new API key and add it to the widget settings. Once you have, the widget will automatically auto-refresh (WP 4.5 and above) and you will now see a map instead.

I have an issue with this plugin, where can I get support?

Please open an issue on Github


April 12, 2017
Very great plugin. Especialty with the navigatefunction. but Not compatible with SSL secured sites (https://) When i activate the widget, Google marked the site not totaly safe. When i remove the widget the site marked als complete safe (SSL)
Read all 6 reviews

Contributors & Developers

“Mobile Map Widget” is open source software. The following people have contributed to this plugin.


Translate “Mobile Map Widget” into your language.

Interested in development?

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



  • November 1, 2018
  • fix deprecated function to register the widget


  • October 29, 2018
  • change link to find coordinates
  • add details new Google API requirements
  • edit readme files with new FAQ entries among others
  • change some links due to renewal SO WP website
  • clean up irrelevant screenshots
  • add new screenshots
  • verified compatibility WP 5.0
  • verified compatibility ClassicPress 1.0.0


  • October 5, 2017
  • remove link to find coordinates as it no longer works
  • change some links due to renewal SO WP website
  • clean up irrelevant screenshots


  • June 1, 2017
  • change default location and pin color
  • clean up tabs and spaces
  • remove redundant language files
  • verified compatibility WP 4.8


  • April 12, 2017
  • change http links to https, props @senatorman


  • November 29, 2016
  • fix typo in settings that link to help map to get coordinates
  • update URL to help map
  • remove version check
  • tested up to WP 4.7


  • March 31, 2016
  • implement selective refresh support for Customizer (WP 4.5 feature)
  • adjust FAQ
  • bump minimum required WP version up to 4.2


  • July 7, 2015
  • in WP 4.3 PHP 4 style constructors are deprecated, the plugin contained such a constructor, therefore replaced with PHP 5 style constructor



  • The location field now also takes an address (credits Google Maps Widget –
  • Add transient (credits Google Maps Widget –
  • Adjust FAQ
  • Tested up to WP 4.0-beta2
  • Bump minimum required WP version up to 3.8


  • Change input type to number for zoom, width and height to address issue #2 and adjust FAQ
  • Add format=jpg to map parameters to allow for the smallest size and progressive loading of the image
  • Fix typo textdomain function
  • Move minimum required WP version up to 3.7


  • Made sure that Widget Preview (WP 3.9 feature) works for the plugin


  • Tested up to WP 3.9-alpha
  • Change format version numbers
  • Add widget default values to get rid of undefined index error


  • Compatible up to WP 3.8


  • change text domain to prepare for language packs (via Otto –



  • Compatible with WP 3.6
  • Prevent direct file access


  • Added optional description field


  • Release version