Troubleshooting: Why Your WP Go Maps Isn't Showing and How to Fix It
Content
One of the most common issues users face with the WP Go Maps (formerly WP Google Maps) plugin is the map not displaying on their website. Instead of the expected map, they often see a blank space, a container with no content, or just a single marker. This can be a frustrating experience, but the root cause is usually one of a few common conflicts or configuration errors.
Based on community support threads and troubleshooting experiences, here are the most frequent reasons for a missing map and the steps you can take to resolve them.
1. Check for the `wp_footer()` Hook
This is one of the most common solutions. Many WordPress plugins, including WP Go Maps, rely on the `wp_footer()` hook being present in your theme's `footer.php` file to output essential scripts. If this hook is missing or commented out, the map will not load.
How to fix it: Open your theme's `footer.php` file and ensure the line <?php wp_footer(); ?> appears just before the closing `</body>` tag. Save the file and clear any caching plugins you may be using.
2. Duplicate Google Maps API Calls
A frequent cause of map failure is the Google Maps API being loaded more than once on the same page. This often creates a JavaScript conflict, preventing the map from rendering. You might see an error in your browser's console (F12) like: "You have included the Google Maps API multiple times on this page."
How to fix it: The duplicate call is usually coming from your theme or another plugin. You will need to identify and disable the extra API call. Check your theme's `functions.php` file for any calls to `wp_enqueue_script` that load the Google Maps API. If you have another map plugin active, try deactivating it to see if that resolves the conflict.
3. Maps in Tabs or Hidden Containers
If your map is placed inside a tabbed interface or any container that is initially hidden (e.g., with `display: none;`), it will often fail to render correctly. The Google Maps API has difficulty calculating the dimensions of a hidden container.
How to fix it: You need to trigger a map refresh when the tab becomes visible. This typically requires custom JavaScript to re-initialize the map or trigger a resize event when the tab is clicked. The exact code will depend on your theme's tab implementation.
4. Incorrect Map Height
Sometimes the map is actually loading, but its container has a height of 0 or 1 pixel, making it invisible. This can happen if the height is set to a percentage value that doesn't have a clear parent container height to reference.
How to fix it: In your map's settings, avoid using a percentage (%) for the height. Instead, use a fixed pixel value (e.g., 450px). You can also add custom CSS to ensure the map container is visible:
.wpgmza_map {
height: 450px !important;
}
5. Plugin or Theme Conflict
General conflicts with your theme or other plugins can prevent the map from loading without a specific error message.
How to fix it: Perform a standard conflict test. Temporarily switch to a default WordPress theme like Twenty Twenty-One. If the map appears, the issue is with your theme. If the map is still missing, deactivate all other plugins except WP Go Maps. If the map works, reactivate your plugins one by one to identify the culprit.
6. Browser-Specific Issues
In some cases, a map may not show in one browser but work in others. This is almost always due to browser extensions, aggressive caching, or specific JavaScript errors that are handled differently by each browser.
How to fix it: Open the browser's developer console (F12) and look for any red error messages. Try loading the page in a private/incognito window with extensions disabled. Clear your browser's cache and cookies for the site.
Summary: Your Troubleshooting Checklist
- Verify
<?php wp_footer(); ?>is in your theme's footer. - Check the browser console (F12) for API duplication or other JavaScript errors.
- Switch to a fixed pixel height for the map.
- Test for theme/plugin conflicts.
- If the map is in a tab, investigate JavaScript reinitialization scripts.
By methodically working through these common issues, you can usually identify and fix the problem causing your WP Go Maps plugin to not display correctly.
Related Support Threads Support
-
Map is not showinghttps://wordpress.org/support/topic/map-is-not-showing-6/
-
map not displayedhttps://wordpress.org/support/topic/map-not-displayed/
-
Map Not Showinghttps://wordpress.org/support/topic/map-not-showing-23/
-
Font Awesome issuehttps://wordpress.org/support/topic/font-awesome-issue-5/
-
Address Not Showing on Maphttps://wordpress.org/support/topic/address-not-showing-on-map/
-
Map showing empty maphttps://wordpress.org/support/topic/map-showing-empty-map/
-
Google Map not showing in Pop Up Windowhttps://wordpress.org/support/topic/google-map-not-showing-in-pop-up-window/
-
WP Google Maps Full Widthhttps://wordpress.org/support/topic/wp-google-maps-full-width/
-
Google Chrome doesn't show the maphttps://wordpress.org/support/topic/google-chrome-doesnt-show-the-map/
-
Page refresh needed to show the map.https://wordpress.org/support/topic/page-refresh-needed-to-show-the-map/
-
Parks are clickable / Can't turn off panhttps://wordpress.org/support/topic/parks-are-clickable-cant-turn-off-pan/
-
WP Google Maps dosen’t show new or updated locationshttps://wordpress.org/support/topic/wp-google-maps-dosent-show-new-or-updated-locations/
-
Post with WP Map not showing on first clickhttps://wordpress.org/support/topic/post-with-wp-map-not-showing-on-first-click/
-
My map is not showing complete on my site /Tab problem HELPhttps://wordpress.org/support/topic/my-map-is-not-showing-complete-on-my-site-tab-problem-help/
-
Blank “WP Google Maps Settings” Pagehttps://wordpress.org/support/topic/blank-wp-google-maps-settings-page/
-
Map Doesnt appear in the contact pagehttps://wordpress.org/support/topic/map-doesnt-appear-in-the-contact-page/
-
Map Not Showinghttps://wordpress.org/support/topic/map-not-showing-11/
-
Map not showing uphttps://wordpress.org/support/topic/map-not-showing-up-5/
-
Map doesn't show on IEhttps://wordpress.org/support/topic/map-doesnt-show-on-ie/
-
Can’t View More Mapshttps://wordpress.org/support/topic/cant-view-more-maps/
-
interface not completehttps://wordpress.org/support/topic/interface-not-complete/
-
Info Window not workinghttps://wordpress.org/support/topic/info-window-not-working/
-
map does not showhttps://wordpress.org/support/topic/map-does-not-show/
-
problem display map and satelite buttonhttps://wordpress.org/support/topic/problem-display-map-and-satelite-button/
-
Map is not showing up when theme Panels are activated.https://wordpress.org/support/topic/map-is-not-when-theme-panels-are-activated/
-
WPGMaps not displaying properly in Safari & Chromehttps://wordpress.org/support/topic/wpgmaps-not-displaying-properly-in-safari-chrome/
-
Copyright notice covering half of my maphttps://wordpress.org/support/topic/copyright-notice-covering-half-of-my-map/
-
WP Google Heatmaps not working!https://wordpress.org/support/topic/wp-google-heatmaps-not-working/
-
Map not appearing on Chrome, no pins on IEhttps://wordpress.org/support/topic/map-not-appearing-on-chrome-no-pins-on-ie/
-
Map is not showing – because of my theme?https://wordpress.org/support/topic/map-is-not-showing-because-of-my-theme/
-
Google maps doesn´t showhttps://wordpress.org/support/topic/google-maps-doesnt-show/
-
MAP THEMEShttps://wordpress.org/support/topic/map-themes/
-
My map is not showing on my websitehttps://wordpress.org/support/topic/my-map-is-not-showing-on-my-website/
-
Plugin screen goes blankhttps://wordpress.org/support/topic/plugin-screen-goes-blank/
-
Blank Settings/Maps Pagehttps://wordpress.org/support/topic/blank-settings-maps-page/
-
infowindows not showinghttps://wordpress.org/support/topic/infowindows-not-showing/
-
Custom Theme / map style not displayed correctlyhttps://wordpress.org/support/topic/custom-theme-map-style-not-displayed-correctly/
-
Maps in tabs not displayinghttps://wordpress.org/support/topic/maps-in-tabs-not-displaying/
-
Multisite Support?https://wordpress.org/support/topic/multisite-support-92/
-
How do you simply add a margin below the map?https://wordpress.org/support/topic/how-do-you-simply-add-a-margin-below-the-map/
-
Google Map is not showinghttps://wordpress.org/support/topic/google-map-is-not-showing/
-
Google map ADDRESS doesn't workhttps://wordpress.org/support/topic/google-address-doesnt-work/
-
Re-initiate WP Google Mapshttps://wordpress.org/support/topic/re-initiate-wp-google-maps/
-
Map Not Showinghttps://wordpress.org/support/topic/map-not-showing-18/
-
Maps not working with tabshttps://wordpress.org/support/topic/maps-not-working-with-tabs/
-
Can't Add Maphttps://wordpress.org/support/topic/cant-add-map/
-
Map not showing in full heighthttps://wordpress.org/support/topic/map-not-showing-in-full-height/
-
problem of map displayhttps://wordpress.org/support/topic/problem-of-map-display/
-
Info Box Lay-out Not Showing/Box Sizehttps://wordpress.org/support/topic/info-box-lay-out-not-showingbox-size/
-
How do I enter Google URL to display restaurant pinhttps://wordpress.org/support/topic/how-do-i-enter-google-url-to-display-restaurant-pin/
-
Google map doesn't appaer on the websitehttps://wordpress.org/support/topic/google-map-doesnt-appaer-on-the-website/
-
map doesn’t work inside accordionhttps://wordpress.org/support/topic/map-doesnt-work-inside-accordion/
-
The font is not visible?https://wordpress.org/support/topic/the-font-is-not-visible/
-
Infowindow not displaying address fullyhttps://wordpress.org/support/topic/infowindow-not-displaying-address-fully/
-
Scrollbars / Infowindow heighthttps://wordpress.org/support/topic/scrollbars-infowindow-height/
-
Map not showinghttps://wordpress.org/support/topic/map-not-showing-19/
-
Map Width 100%https://wordpress.org/support/topic/map-width-100/