Join WPMU DEV to share maps with

Google Maps

Add simple controls and a ton of options for easily embedding, styling and customizing Google Maps to look amazing on your WordPress site. Create interactive maps with custom drop-pins to make your contact form or share your store locations.

Downloads 108,903
Ultra Compatible
Version 2.9.4

Changelog / Translations

Version 2.9.4
  • Fix: PHP Notice on Events Map Options
  • Fix: Google Maps Marker cluster causing a JS error
  • Fix: Geotagging limit
  • Fix: PHP notice with missing geotagging results
Version 2.9.4
  • Fix: PHP Notice on Events Map Options
  • Fix: Google Maps Marker cluster causing a JS error
  • Fix: Geotagging limit
  • Fix: PHP notice with missing geotagging results

Version 2.9.3
  • Fix: additional query escaping
  • Fix: disable draggable when scroll disabled
  • Fix: events map shows up ONLY every other time page loads

Version 2.9.2
  • Add: FB app limitations notice
  • Add: manual marker folding in profile maps
  • Fix: protocol-less avatars for individual BP profiles
  • Fix: BuddyPress deprecation notices
  • Fix: options check shorting out on no dedicated tab setting

Version 2.9.1
  • Fix: add maps API key support.
  • Fix: update deprecated CDN path for cluster images.
  • Fix: integration function existence checks.
  • Fix: maps editor and insertion issue in some scenarios.
  • Fix: maps scroll disabling behavior.
  • Fix: maps title sanitization improvement.

  • Fixed compatibility issues with latest versions of WP.

  • Fix rendering issue in some browsers (e.g. Chrome 39)

  • Minor bugfixes and improvements in code

  • Fix: BuddyPres Profile map handles address changes from admin dashboard
  • Improved: Custom Field for "Address" can take a list of fields now

  • Fix: BuddyPres Profile map updates correctly when address is changed
  • Fix: Maps generated with the location-shortcode are linked to post
  • Fix: Map-Editor in the Widget screen updated/fixed

  • Improved default values for query-parameter in the [map] shortcode
  • Fix possible incompatibility with PopUp Pro plugin

  • Improved UI of the Map-Editor dialog.
  • Fix: Merging and batch-deleting maps now works.

  • Fix: Rare script error in post editor due to undefined script loading order.
  • Fix: Correct the behavior of center-map for overlay maps.
  • Fix: Auto generated maps start with meaningful default options.
  • Fix: The Add-On "KML Uploader" can be activated again.

Version 2.9
  • Fix: Overlay maps will now ignore the show_map option of individual maps.
  • Fix: Boolean shortcode attributes now understand "true/on/yes/1" (before only "1").
  • Fix: Some shortcodes did throw an error when no attribute was defined.
  • Add-On "BP Profile map": Now respects the visibility option of the address field.
  • Add-On "BP Member map": Merged with "BP Profile map" since both Add-ons are almost identical.
  • New: filter to only show active/inactive Add-ons.
  • Improved documentation for most Add-ons.

  • Fixed: Added validations to prevent javascript errors in rare cases.

  • New: [map]Click here[/map] shows a link which opens the map when clicked.
  • New option: Enable alternative shortcode [agm_map] instead of [map].
  • New repair tool: Update posts to switch between [agm_map] and [map].
  • Improved: Better layout of “insert map” popup in the post editor.
  • Fixed: Shortcode attribute show_images=”0? now works for all shortcodes.
  • Add-on “BuddyPress Groups”: Fixed issue with title of the group marker.

Version 2.8.6
  • Add-on "BuddyPress Groups": Group markers use the group name as title.
  • New javascript event to execute custom javascript code when user clicks on a marker.
  • Add-on "KML overlay" fixed: It is possible to remove overlays again.
  • Add-on "center map" fixed: New maps have no center anymore.

Version 2.8.5
  • New: Custom icons add-on to add more marker icons.
  • New: Center map add-on now displays a "center" button in the map preview.
  • Fix: Bug with custom sorting is fixed.
  • Improved Add-On management: Dependencies are displayed and checked.
  • Improved navigation on map settings page: Current tab stays open after saving.

  • Fixed: Map popup opens correctly when creating a new post.

Version 2.8.4
  • New: Javascript hook to change the sort order in the marker-list.
  • Fix for User Check-ins: Solve javascript error when map had no markers.
  • Fix for User Check-ins: Set meaningful default values for users.

Version 2.8.3
  • New: Added the "traffic overlay" add-on.
  • Fix: Small improvements in the map options popup in WordPress Admin.
  • Fix: Repeated "update to 2.8.2" issue.

  • Fix: Security update that prevents malicious input in custom CSS.

Version 2.8.1
  • Fix the repeated "update to 2.8" issue.

Version 2.8
  • Fix: Plugin compatibility with WordPress 3.9.
  • New: Improving the layout of admin section of the plugin.
  • New: Added the "User check-ins" add-on and two shortcodes.
  • Fix: A few smaller bugfixes.

Version 2.7.1
  • Tightened request failure catching for geocoding results.
  • Added the plural group maps shortcode.
  • Added the map tiles caching.

Version 2.7
  • Improving member profile markup filtering.
  • Conditionally including the dependencies with legacy fallback.
  • Fix for map title escaping.
  • Added the location add-on and shortcode.
  • Added the BuddyPress group maps add-on.
  • Added the scroll disabling add-on.

Version 2.6.4
  • Center map attribute in derived maps shortcode.
  • Added directions snapping options.
  • BuddyPress activities geotagging request filter rejection.

Version 2.6.3
  • Fix for Google Maps library loading race condition.

Version 2.6.2
  • Editor paging for maps.
  • Added public transit transportation mode.
  • Added `current_post` query.
  • Added advanced mode zoom settings.
  • Deprecated external dialog styles.

Version 2.6.1
  • Fix for legacy root URL support.

Version 2.6
  • Added Google Places support add-on.
  • Added "Where am I?" add-on.
  • Added Nearby Facebook Friends add-on.
  • Added geotagging add-ons for WordPress and BuddyPress.
  • Added auto-generated maps marker hiding add-on.
  • Added discard old map option for auto-generated maps.
  • Exposed more hooks and events for interaction.

Version 2.5.6
  • Applying the new limit define as default.
  • Exposing the limit for filtering and as shortocde parameter.

Version 2.5.5
  • Silencing some notices.
  • Fix for hidden maps offset on show/resize.

Version 2.5.4
  • Fix for proper display of initially hidden maps.
  • Fix for marker snapping on editing the existing maps

Version 2.5.3
  • Added snapping option.

Version 2.5.2
  • Swapped the order of direction waypoint entries.
  • Typo fix.

Version 2.5.1
  • Added localization add-on.

Version 2.5
  • Added member profile bindings rebuilding in Fix and Repair add-on.
  • Added map centering add-on.
  • Added Marker cluster add-on.
  • Added experimental featured image add-on for overlay maps.

Version 2.4.1
  • Fix for https links.

Version 2.4
  • Added BuddyPress profile maps add-on.
  • Added template tag for showing BuddyPress members on one map.
  • Added shortcode for showing BuddyPress members on one map.
  • Fix for img styles bleedthrough issue.

Version 2.3.1
  • Added default map table charset and collation on install.

Version 2.3
  • Fix for media buttons compatibility with WordPress 3.3.
  • Autocreated maps re-creation on watched field change - thanks, Moha!
  • Added KML support through Add-ons.

Version 2.2
  • Added plugin infrastructure.
  • Added "Fix and Repair" plugin
  • Shortcode queries "all" and "random" work with "network" attribute.
  • Fix for map editor and popup bubble sizes on low resolution screens.

Version 2.1.1
  • Fix for merged maps widget options bleed through for singular maps.

Version 2.1
  • Added new "Zoom" attribute for merged maps in widget.
  • Allowed for Map Types in shortcode.
  • Added measurement units support in plugin defaults.

  • Fixed notices.

Version 2.0.4
  • Fixed fetching permalinks for network post mashups.

Version 2.0.3
  • Fixed network marker merging.
  • Fixed fetching newly merged network post titles.
  • Added shortcode zoom attribute.

Version 2.0.2
  • Fixed delete link in Editor.

Version 2.0.1
  • Fix for errors with non-numeric zoom values.

Version 2
  • Map alignment support
  • Maps overlays (showing multiple maps as one)
  • Integration with Post Indexer plugin
  • Option for showing associated post titles
  • Automatic map creation from custom fields
  • Panoramio images overlay
  • Saving maps in Street View

Version 1.0.5
  • Fix for themes including the same scripts multiple times.

Version 1.0.4
  • Fix for map size parsing in some setups.

Version 1.0.3
  • Fix for map markers toggling.

Version 1.0.2
  • Map preview height is dynamically determined in admin area (map editors).
  • Link to directions is on a line of its own when map is rendered to the user.
  • Removed duplicated language strings.

Version 1.0.1
  • Fix for image strip checkbox.

Version 1-BETA-1
    Easily embed, customize and display Google maps in posts, pages and widgets.
    • Style with custom CSS or Snazzy Maps
    • User check-in and current location display
    • Traffic, panorama image, and KLM overlay
    • Support for Google places
    • Hide auto-created markers
    • Custom drop-pins

    Google Maps allows you to embed, customize and display Google maps on your WordPress site.

    Forget messing around with code – this plugin lets you easily add a map to a page or post, or drop a map onto your site using a custom widget.

    Share a big beautiful map on your contact page.
    Share a big beautiful map on your contact page.

    Styled for You

    Get a simple little “Add Map” icon added to your Visual Editor. Share big beautiful maps with street view and custom drop-pins.

    Google Maps integrates with any theme, offering a clean minimalist solution for displaying maps.

    Overlay traffic and get users to your location faster.
    Overlay traffic and get users to your location faster.

    Door-to-Door Service

    Place a responsive, interactive map on your contact page. Provide a link to smartphone GPS that directs users to your front door from anywhere.

    Use traffic overlay and make sure users know the quickest route at any given time.

    Design custom icons to highlight your location.
    Design custom icons to highlight your location.

    Custom Icons

    Design your own icons and use them to display custom locations. Get incredible control over the entire look and feel with of your site and draw attention to important locations.

    You can even use CSS for additional styling that really make maps pop.

    Start by reading Installing plugins section in our comprehensive
    WordPress and WordPress Multisite Manual if you are new to WordPress.

    To install:

    1.  Download the plugin file
    2.  Unzip the file into a folder on your hard drive
    3.  Upload /wpmu_dev_maps_plugin/ folder to /wp-content/plugins/ folder on your site
    4.  Login to your admin panel for WordPress or Multisite and activate the plugin:

    • On regular WordPress installs – visit Plugins and Activate the plugin.
    • For WordPress Multisite installs – Activate it blog-by-blog (say if you wanted to make it a Supporter premium plugin), or visit Network Admin -> Plugins and Network Activate the plugin.

    To Use:

    The Google Map plugin adds a “Add Map” icon to your visual editor. Once you’ve created your new map it is inserted into write Post / Page area as shortcode which looks like this: [map id=”1″].

    It also includes a Google Maps widget for displaying maps in your site’s sidebar as well as the ability to create mashups from your maps.

    You’ll find detailed instructions for using this plugin by going to Settings > Google Maps plugin where you can also configure your preferred Google Maps defaults.

    Configuring your default Google Maps options

    1.  Go to Settings > Google Maps plugin

    Google Maps Dash

    2.  Select your preferred Google Maps defaults from the options available.

    Google Maps Settings

    The various default settings  control the Panoramia images for each of your new map locations. This can be pretty nice for locations that don’t have Street View option in Google Maps.

    You control whether a map does or doesn’t display the Panoramia images widget below the map using the Map Options in the Add Map window. (See Adding a Google Map to a Post or Page further on below.)

    The default map type controls which type of Google Map is embedded. Changes to Default map type applies to newly created maps only; not previously created maps.

    Examples of Google map types

    3. Custom Fields

    Google Maps Custom Fields

    The Custom Fields settings allow you to set specific Longitude and Latitudes, which when found in a post will automatically create a Google Map in it’s place. Which in combination with the default alignment and size settings mentioned earlier, can be quite the powerful tool for showing locations on your website!

    4. Select your Add-ons.

    Our Google Map plugin has all kinds of great Add-ons to give your maps some awesome features!

    Google Maps Add-ons

    Simply select which ones you’d like included, and you’re all set!

    5. Don’t forget to click Save Changes!

    Adding a Google Map to a Post or Page

    The Google Map plugin adds a “Add Map” icon to your visual editor. Once you’ve created your new map it is inserted into write Post / Page area as shortcode which looks like this: [map id="1"].

    It also adds a widget so you can add maps to your sidebar (see Appearance > Widgets).

    Let’s take a look!

    1.  When creating a new post or page, Click on the Add Map icon. Which will bring a pop over for creating new maps, or reusing already created ones.

    Google Maps Add Map icon

    Google Maps new map

    2.  Add the address of the location you want to add and then click Add.  This adds a place marker to your map and displays the location at the bottom of the map.

    3.  To add more location(s), just add the address(es) and then click Add.

    4.  Alternatively you can add a location(s) by zooming in on your map, click on Drop Marker to add a Marker to your Map and then drag/drop it to the desired location.

    5.  Be sure to give your map a name.

    6.  Now zoom in on your place marker(s) so your readers have the best map view of your location.

    Google Maps NYC

    7.  Click on the Place Marker if you want to change the Title of location or Information about the location. You can also click on the Icon to change the Marker’s icon.

    Google Maps Pin info

    8.  Next click Save changes to this map.

    9. Finally click on Map Options, select your preferences , click OK to close the Map Options window and then click Insert this map.  Select “Associate map with this post” if you want to be able to create mashups with your maps.

    Map Options

    10. You should now see your map shortcode displayed and your Google map embedded in your Post or Page when published.

    Map ID

    On load on the public facing pages, maps are always centered to the last existing marker location.

    Adding your Google Map(s) to your sidebar

    The Google Maps widget can be used to add an existing map, create a new map or add a mashup of maps to your site’s sidebar.

    1.  Go to Appearance > Widgets

    2.  Click and drag to Add the Google Maps Widget to the desired sidebar or widget area and configure the widget.

    Google Maps Widget

    Creating mashups of your maps

    Mashups can be easily created by either using Map Query shortcode (for posts) or by setting them up in Widget Options (for widgets).

    You need to have selected “Associate map with this post” in the Map Options window when creating a map for that map to be displayed using Map Query tag  shortcode.

    The following shortcode can be used for the custom query in the Google Maps widget to create mashups:

    [map query=”tag=tagname”] – This shows all maps associated with any posts tagged with that tag on the site.  For example,  [map query=”tag=New York”] displays all maps associated with posts tagged New York.


      when you use this with the Widget, you only need to provide the actual query, in this case “tag=New York”, without the quotes as shown in the screenshot below:

    Mashups 1

    The following shortcodes can be used in posts to create mashups:

    [map query=”all”]  – This shows all maps associated with any posts on the site.

    [map query=”current”] – This shows all maps associated with posts currently on the site.

    [map query=”random”] – This shows a random existing map. It always displays a single map.

    [map query=”tag=tagname”] – This shows all maps associated with any posts tagged with that tag on the site.
    For example,  [map query=”tag=New York”] displays all maps associated with posts tagged New York.

    Creating a map query for a post or page

    The following attributes can be used with shortcodes:

    • overlay  – When set as true, this shows all markers from the queried posts overlayed on a single map.
    • width – You can set this to display a relative or absolute width for the map.
    • height – You can set this to display a relative or absolute height for the map.
    • show_images – Shows images when set to true and will hide them when false.
    • show_map – Setting this to false will not display the map, useful for when you want to show just the list of markers.
    • show_posts – Displays a link to the post for which a marker is associated.
    • map_type – Can be set to: “ROADMAP”, “SATELLITE”, “HYBRID”, or “TERRAIN” to have the map rendered in that mode of display.
    • network – When used on a Multisite, displays network post markers when set to true.

    Shortcode examples:

    As an example, you can use the following shortcode which displays a single map that’s as wide as possible (within theme constraints), which includes all markers from all posts on the current site.

    [map query=”all” overlay=”true” show_posts=”true” width=”100%”]

    The Following will show one map, which will have all markers from maps associated with all posts on the network that have the tag “my_tag”. It will have a list of markers displayed below it and the markers themselves will have a list of links to posts associated with their original map. The Panoramio image gallery will not be shown. The map itself will be as wide as possible (it will fill all available space), but it will be only 100px high.

    [map query=”tag=my_tag” network=”true” overlay=”true” show_images=”false” show_posts=”true” height=”100px” width=”100%”]

    You can also use a variety of attributes to your shortcodes to create the exact map you want.  Zoom for instance can be setup using a number (1-20) or a label.  Here’s how the numbers relate to their respective labels:

    ‘1’ => Earth
    ‘3’ => Continent
    ‘5’ => Region
    ‘7’ => Nearby Cities
    ’12’ => City Plan
    ’15’ => Details

    And here’s what a sample shortcode would look like:

    [map id=”2″ zoom=”18″]

    Google Maps is covered by the WPMU DEV Guarantee

    WPMU DEV Guarantee

    We guarantee that...

    • Google Maps will work as advertised
    • You will receive 24/7 365 expert support for any problem
    • If you cancel your FREE trial, you can keep Google Maps
    • Google Maps is secure, always updated and well coded

    Money back guarantee!

    While you have 30 days, no obligations risk-free trial of WPMU DEV if you become a paid member and are dissatisfied with any of the above we'll refund you, no questions asked.

    Take Advantage of All the Great Features

    Create as many Google maps as you need using this powerful and flexible plugin.

    • Easily embed maps using built-in "Add Map" Icon
    • Drag and drop a map onto any widgetized area
    • Customize maps to fit your site
    • Add latitude and longitude fieldnames
    • Display in street view
    • Insert custom drop-pins
    • Panorama image overlay
    • Custom CSS to customize maps
    • Extensive BuddyPress support
    • Display visitor's current location
    • Create responsive maps
    • Google Places support
    • Map location shortcode
    • KML overlay
    • Disable map scrolling
    • BuddyPress profile maps
    • BuddyPress groups map
    • BuddyPress profile map
    • Geotag posts and activities
    • Marker clustering for cleaner maps
    • Traffic overlay
    • Create and upload custom icons
    • User check-in
    • Hide auto-created markers
    • Integrates with Events +