Skip to content
WP Go Maps Documentation

Initial Setup

3
  • Installing the Plugin
  • Map Engine Selection Guide
  • Changing your Map Engine

Map Engines

8
  • Creating a Google Maps API key
  • Protecting your Google Maps API key from unauthorized use – Setting up website restrictions (HTTP referrers)
  • Creating an Azure Maps subscription key
  • Creating a Stadia Maps API Key
  • Creating a MapTiler API Key
  • Creating a LocationIQ Access Token
  • Address Providers
  • Tile Servers & Tilesets

First-time users

3
  • Creating your first map
  • Creating your first marker
  • Displaying your Map on your WordPress site

Map Features

50
  • Map Features Overview
  • Accessibility and WCAG Compliance
  • Shortcodes
    • Shortcodes – Quick Start
    • Map Shortcode
    • Store Locator Shortcode
    • Category Filter Shortcode
    • Category Legends Shortcode
    • Infowindow Shortcode
    • Marker Listing Shortcode
    • Directions Shortcode
    • Using WP blocks
  • Markers
    • Editing a Marker
    • Marker Gallery
    • Fine-tuning a Marker’s position
    • Adding video to your Marker
    • Embedding iframes in your markers
    • Customizing your info Window
    • Info Window Styles
    • Using Custom marker Icons on your map
    • Sticky Markers
    • Adding Custom fields to your Marker
    • Marker Listing
    • Enabling distance features
  • Map Display
    • Setting your Map type
    • Using your map in a widget
    • Styling Wizard
    • Using GET variables to Control your Map
  • Filtering
    • Store Locator
    • Marker Filtering
    • Enabling the category Legend
    • Shape Filtering
  • Shapes
    • Shape Info Windows
    • Shape Library
    • Polyline & Polygon Line Styles
  • Performance & Analytics
    • Optimization
    • Map Insights
    • Marker Caching
  • Drawing Tools
    • Adding a Polygon
    • Adding a Polyline
    • Adding a Circle
    • Adding a Rectangle
    • Adding an image overlay
    • Adding a Point Label
    • Adding a Heatmap
  • Themes
    • Creating a Custom Map Theme – Google maps engine
    • Change your Map Theme – Theme Presets for OpenLayers & Leaflet
    • Edit your Map Theme – Theme Editor for OpenLayers & Leaflet
    • Using a custom image as a map tile
  • Directions
    • Enabling Directions
    • Enabling Directions with OpenRouteService

Integrations

8
  • Integrations Overview
  • WooCommerce – Checkout Map
  • WooCommerce – Product Location Editor
  • Translating the plugin with WPML
  • Post Type Locations
  • Advanced Custom Fields
    • Advanced custom fields
    • Enabling simple ACF Fields for display in the description field of the Info Windows of your ACF Map
    • Using Custom images as the marker icons for your ACF map markers

Importing and Exporting Data

5
  • Importing Files
  • Exporting Data and Settings
  • Bulk JPEG Import
  • Using KML and GeoRSS files
  • Improving Reliability of Scheduled Imports

Frequently Asked Questions

33
  • System Requirements
  • How to create an Administrator account for Support agents
  • GDPR
  • Licensing & Account
    • Purchase Model
    • Plugin Licenses
    • I am an NPO
    • I did not receive my invoice?
    • How can I upgrade my purchase of WP Go Maps
    • Where can I get a new download of the plugin
    • How do I update WP Go Maps?
  • Map Functionality
    • Map Tilt Controls
    • Marker Render Mode
    • Finding Custom Marker Icons
    • Why did my suggestions stop working?
    • How do I change scroll/pan behaviour on a mobile device
    • How do I dynamically set the search area in the Store locator
    • How do I Start the map in Street View
    • How to Create a Marker Cluster (Group)
    • How to use real time tracking
    • Marker Ratings
    • Why aren’t my ACF, WooCommerce or Post Locations Markers showing on my map?
  • Technical
    • How to add Support agents to your Google API Project
    • How do I change the WP Go Maps Plugin Language
    • How do I restrict Autocomplete to a Specific Country
    • Using WP Go Maps with Elementor
    • How can I disable externally hosted Google fonts so that I can be GDPR compliant?
    • WP Go Maps and Webcraftic Clearfy
    • I have a Customization Request
  • User Generated Content
    • How to allow visitors to create markers
    • Separating the VGM form from the Map
  • Integrations
    • WP Rocket – Map Won’t Load
    • Real Cookie Banner – Map Won’t Load
  • Hosting
    • One.com – Markers not loading

Troubleshooting

12
  • Autocomplete Disabled
  • Use my location is not working
  • I’m Getting a Maps Multiple API Error
  • I’m Getting a “jQuery not found” Error
  • My Map is Not Showing On My Website
  • Markers Are Not Showing on My Map on the Front-end
  • API Not Activated Map Error
  • This page can’t load Google Maps correctly
  • This API project is not authorized to use this API
  • Geocode failed (Request denied) error
  • My import is not working – Geocode failed (Missing address, lat and lng) (Rows: 2, 3, 4, 5, 6, 7, 8….)
  • This folder does not exist, please create it.

Customization

9
  • Customization Guides
  • Markers & Info Windows
    • Dynamic Marker Creation
    • Open Marker by Title (URL)
    • Open Marker by Marker Field (URL)
    • Updating Panel Info Window Dynamically
  • Maps
    • Map Manipulation
    • Refresh Map in Realtime
  • Database
    • Creating a Marker (PHP)
    • Edit & Remove Marker (PHP)

Developers

91
  • Basic Changelog
  • Pro Changelog
  • Gold Changelog
  • VGM Changelog
  • Templates
    • Template Overrides
  • Hooks
    • Filters
      • Basic
        • wpgooglemaps_filter_map_div_output
        • wpgmza_admin_persistent_notices_dynamic_titles
        • wpgmza_admin_persistent_notices_dynamic_messages
        • wpgmza_admin_persistent_notice
        • wpgmza_admin_ui_menu_current_action
        • wpgmza_create_{$class}
        • wpgmza_gdpr_notice
        • wpgmza_gdpr_settings_tab_content
        • wpgmza_plugin_get_default_settings
        • wpgmza_google_maps_api_params
        • wpgmza_internal_engine_build_version_plugins
        • wpgmza_internal_engine_build_version_flags
        • wpgmza_internal_engine_build_version
        • wpgmza_xml_cache_generated
        • wpgmza_fetch_integrated_markers
        • wpgmza_plugin_get_localized_data
        • wpgmza_settings_danger_zone_truncate_tables
        • wpgmza-get-library-dependencies
        • wpgmza_global_settings_tabs
        • wpgmza_global_settings_tab_content
        • wpgmza_global_settings_save_redux
        • wpgmza_map_shortcode_get_default_attributes
        • wpgmza_shortcode_map_options
        • wpgmza_map_shortcode_get_html_attributes
        • wpgmza_shortcode_map_components
        • wpgmza_shortcode_map_container_before
        • wpgmza_shortcode_map_container_inside
        • wpgmza_shortcode_map_container_after
        • wpgmza_sl_shortcode_get_default_attributes
        • wpgmza_standalone_component_classlist
        • wpgmza_standalone_component_wrap_attributes
        • wpgmza_store_locator_radii_options
        • wpgmza_localized_strings
        • wpgmza_system_info_compile_items
        • wpgmza-map-editor-navigation-{$dataGroup}
        • wpgmza-map-editor-settings-{$dataGroup}
        • wpgmza-map-editor-settings-blocks
        • wpgmza-map-editor-sidebar-blocks
        • wpgmza_styling_settings_save
    • Actions
      • Basic
        • wpgmza_admin_notice_process_background_action
        • wpgooglemaps_hook_user_js_after_core
        • wpgooglemaps_basic_hook_user_js_after_core
        • wpgooglemaps_hook_user_js_after_localize
        • wpgmza_admin_persistent_notices_create_defaults
        • wpgmza_admin_ui_menu_registered
        • wpgmza_admin_ui_menu_items_added
        • wpgmza_admin_ui_render_content_before
        • wpgmza_admin_ui_render_{$action}_before
        • wpgmza_admin_ui_render_{$action}_after
        • wpgmza_admin_ui_render_content_after
        • wpgmza_check_map_editor_backwards_compat
        • wpgmza_admin_ui_render_content_before
        • wpgmza_admin_ui_render_{$pageSlugged}_before
        • wpgmza_admin_ui_render_{$pageSlugged}_after
        • wpgmza_admin_ui_render_content_after
        • wpgmza_country_select_created
        • wpgmza_require_feature_classes
        • wpgmza_installer_page_created
        • wpgmza_installer_page_on_post
        • wpgmza_map_list_page_created
        • wpgmza_xml_cache_saved
        • wpgmza_page_dom_add_form_nonces
        • wpgmza_plugin_core_on_activate
        • wpgmza_plugin_core_on_deactivate
        • wpgmza_plugin_core_on_init
        • wpgmza_plugin_core_on_first_run
        • wpgmza_plugin_load_scripts
        • wpgmza_plugin_core_update_all_xml_files
        • wpgmza_settings_danger_zone_before_delete
        • wpgmza_settings_danger_zone_after_delete
        • wpgmza_register_rest_api_routes
        • wpgmza_rest_api_init
        • wpgmza_script_loader_enqueue_styles
        • wpgmza_enqueue_scripts
        • wpgmza_script_loader_enqueue_scripts
        • wpgmza_script_loader_localize_data_complete
        • wpgmza_script_loader_enqueue_custom_js
        • wpgmza_script_loader_enqueue_custom_css
        • wpgmza_script_loader_enqueue_codemirror
        • wpgmza_script_loader_enqueue_writersblock
        • wpgmza_global_settings_page_created
        • wpgmza_shortcodes_registered
        • wpgmza_shortcode_before_output
        • wpgmza_base_upgrade_hook
        • wpgmza_map_edit_page_created
        • wpgmza_styling_page_created

Archived: Legacy (V9)

39
  • First-time users (Legacy)
    • Creating your first map (Legacy)
    • Creating your first marker (Legacy)
    • Displaying your Map on your WordPress site (Legacy)
  • Map Features (Legacy)
    • Store Locator (Legacy)
    • Shortcodes (Legacy)
    • Setting your Map type (Legacy)
    • Using GET variables to Control your Map (Legacy)
    • Using your map in a widget (Legacy)
    • Markers (Legacy)
      • Editing a Marker (Legacy)
      • Sticky Markers (Legacy)
      • Marker Gallery (Legacy)
      • Enabling distance features (Legacy)
      • Marker Filtering (Legacy)
      • Embedding iframes in your markers (Legacy)
      • Adding video to your Marker (Legacy)
      • Customizing your info Window (Legacy)
      • Marker Listing (Legacy)
      • Using Custom marker Icons on your map (Legacy)
      • Adding Custom fields to your Marker (Legacy)
      • Fine-tuning a Marker’s position (Legacy)
    • Drawing Tools (Legacy)
      • Adding a Polygon (Legacy)
      • Adding a Polyline (Legacy)
      • Adding a Circle (Legacy)
      • Adding a Rectangle (Legacy)
      • Adding a Heatmap (Legacy)
    • Themes (Legacy)
      • Creating a Custom Map Theme – Google maps engine (Legacy)
      • Change your Map Theme – Theme Presets (Legacy)
    • Directions (Legacy)
      • Enabling Directions (Legacy)
      • Enabling Directions for OpenLayers (Legacy)
    • User Interface Style (Legacy)
      • User Interface Style (Legacy)
  • Integrations (Legacy)
    • Advanced custom fields (Legacy)
    • Translating the plugin with WPML (Legacy)
    • WooCommerce – Product Location Editor (Legacy)
    • WooCommerce – Checkout Map (Legacy)
  • Importing and Exporting Data (Legacy)
    • Importing Files (Legacy)
    • Exporting Data CSV
    • Exporting Data (JSON)
    • Bulk JPEG Import (Legacy)
    • Using KML and GeoRSS files (Legacy)
View Categories
  • Home
  • Docs
  • Troubleshooting
  • My Map is Not Showing On My Website

My Map is Not Showing On My Website

4 min read

Please try the following steps in sequence to resolve maps display issues

  • Create a Google Maps API Key
  • Flush/Empty/Delete Your Cache
  • Check Your Theme’s footer.php File
  • Verify That jQuery is Installed
  • Are You Trying to Display the Map in Tabs or Accordions?
  • Determine Whether Your Page is Producing Any JavaScript Errors
  • Do You Have a Map Theme Selected?

Create a Google Maps API Key #

Please ensure you have followed these instructions for Creating a Google Maps API key. We suggest you go through that article thoroughly, comparing the information there with your own Google API Manager project. If after doing so, you are sure you have followed these instructions and that all of the required APIs are enabled, then refresh the page that contains the Map’s shortcode in your browser. If the Map is still not showing, please continue with Flush/Empty/Delete Your Cache.

Flush/Empty/Delete Your Cache #

Please ensure that your flush (or empty or delete depending on the software used) your cache files. If your web hosting provider has caching enabled on the web server, ensure that cache is emptied as well. If you are using the CDN option on your caching plugin, please ensure that XML files are excluded from the CDN.After doing so, refresh the page that contains the Map’s shortcode in your browser. If the Map is still not showing or if you know you are not running any caching software in WordPress or on your web server, please continue with Check Your Theme’s footer.php File

Check Your Theme’s footer.php File. #

Some custom WordPress theme developers forget to install a very important standard WordPress hook called wp_footer(); which many plugins, including WP Go Maps, use.

Ensure that your theme’s footer.php file has this hook by doing the following:

Log in to the admin section of your WordPress site as an Administrator.

Go to

WordPress Dashboard -> Appearance -> Theme Editor

Note: This function may be deactivated for security reasons and the Editor option may not be present on your WordPress site. If this is the case, you’ll need to view your WordPress theme’s footer.php file using a text editor and FTP. While viewing the footer.php file make sure that wp_footer(); is called just before the closing tag. See the image below for an example. If the wp_footer(); code is missing from your theme add this line to your theme’s footer.php file: . Note: This example is based on the previous line being straight HTML (which it normally is). If the line in your theme is PHP code use this code instead wp_footer(); ?>. If you have changed the footer.php file, save it and upload it to your server to your theme’s folder (where you downloaded it) if you are working with the file via FTP. If you modified your footer.php file, refresh the page that contains the Map’s shortcode in your browser. If the Map is still not showing or if you did not modify your footer.php file, please continue with Verify That jQuery is Installed.

checking for  wp_footer();

checking for wp_footer();

Verify That jQuery is Installed #

If jQuery is not installed in your WordPress theme, you should be seeing the following error message where your Map should be displayed:

jquery-map-issue

jquery-map-issue

If you are seeing this error message, please follow the troubleshooting steps in the I’m Getting a “jQuery not found” Error document

If you are not seeing this error message, please continue with Are You Trying to Display the Map in Tabs or Accordions.

Are You Trying to Display the Map in Tabs or Accordions? #

If you are trying to display the Map in a Tab or an Accordion and your Map is not displaying on the front-end of your site, you’ll need to modify the WP Go Maps code to work with your particular Tab or Accordion implementation. We have implemented a check for this but it may not work as it should with your particular theme or plugin.

Please open wp-google-maps-pro/js/core.js in a text editor and search for the following code:

JS

jQuery(‘body’).on(‘tabsactivate’,function(event, ui){

for(var entry in wpgmaps_localize){

initMap(wpgmaps_localize[entry][‘id’],’all’,false);

}

});

Directly below this text, add the following:

JS

jQuery(‘body’).on(‘click’,’.the_class_name_of_your_tab_or_accordion’,function(event, ui){

for(var entry in wpgmaps_localize){

InitMap(wpgmaps_localize[entry][‘id’],’all’,false);

}

});

Replace the ‘.the_class_name_of_your_tab_or_accordion’ with the relevant class name of the element from your plugin or theme.

If this code above does not work properly, you can try adding the following:

JS

jQuery(‘.the_class_name_of_your_tab_or_accordion’).click(function(){

setTimeout(function(){

for(var entry in wpgmaps_localize){

InitMap(wpgmaps_localize[entry][‘id’],’all’,false);

}

},500);

});

You can then set the timeout in milliseconds (where the 500 is) to what you require on your site, either a higher or lower number.

Change the modified file and upload back to the appropriate folder on your web server. Refresh the page that contains the Map’s shortcode in your browser. If the Map is still not showing, please continue with Determine Whether Your Page is Producing Any JavaScript Errors.

Determine Whether Your Page is Producing Any JavaScript Errors #

Use this WordPress tutorial to help identify JavaScript errors on your website’s front-end. See https://codex.wordpress.org/Using_Your_Browser_to_Diagnose_JavaScript_Errors#Chrome

Alternatively, review this page for further help.

Do You Have a Map Theme Selected? #

The WP Go Maps Plugins allow you to enter custom JSON theme data. It allows you to style the map to suit your site. However, there are some cases where the lack of a theme will cause the Map or the Markers to no longer show on your site. To rectify this, please navigate as follows to select a present theme and save the map

WP Go MAPS -> Maps (edit your chosen map) -> Themes

Updated on January 20, 2025

Was this helpful?

  • Happy
  • Normal
  • Sad
Share Document:
  • Facebook
  • X
  • LinkedIn
  • Pinterest
Table of Contents
  • Create a Google Maps API Key
  • Flush/Empty/Delete Your Cache
  • Check Your Theme’s footer.php File.
  • Verify That jQuery is Installed
  • Are You Trying to Display the Map in Tabs or Accordions?
  • Determine Whether Your Page is Producing Any JavaScript Errors
  • Do You Have a Map Theme Selected?
Documentation by WP Go Maps