Skip to content
WP Go Maps Documentation
Home

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

34
  • System Requirements
  • How to create an Administrator account for Support agents
  • GDPR
  • Licensing & Account
    • Why am I getting “Domain Limit Exceeded” for my License key
    • 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
  • Map Engines
  • Tile Servers & Tilesets

Tile Servers & Tilesets

5 min read

Our map display system, which leverages open-source libraries like Leaflet and OpenLayers, is powered by a central configuration of Tileservers. A Tileserver provides the image or vector tiles that form the base layer (the “look and feel”) of your map.

We have over 50 tile servers available for Leaflet and OpenLayers from 9 providers. When you select a Provider (or engine preset powered by Leaflet/OpenLayers), the available tile server list automatically updates to only allow tilesets from that provider. This means you only need to set up one key (if required) to access all subsequent map styles from the same provider.

Available Tile Servers #

The table below organizes the available map styles (Tilesets) by their primary Provider, making it easy to see all the options available once a main Provider is selected.

Provider NameTileset Name (Label)Key RequiredDescription/Style
OpenStreetMapStandardNoThe worldwide, community-driven default OSM map style.
DE (German)NoOpenStreetMap style with a focus on Germany.
FR (France)NoOpenStreetMap style with a focus on France.
CyclOSMNoMap style optimized for cycling and bicycle routing.
HumanitarianNoHumanitarian OpenStreetMap Team (HOT) style, focused on disaster response.
OpenFreeMapLibertyNoClean, bright vector style using OpenMapTiles data.
BrightNoA vibrant vector map style.
PositronNoA light, neutral basemap vector style, ideal for overlays.
Microsoft Azure (Bing)RoadmapYesStandard road and street map with detailed coverage.
SatelliteYesHigh-resolution satellite imagery with road labels overlay.
Imagery OnlyYesSatellite and aerial imagery without road labels.
Dark GreyYesDark-themed, monochromatic map, great for data visualization.
Weather (Radar)YesWeather data overlay showing real-time radar.
Weather (Infrared)YesWeather data overlay showing infrared satellite imagery.
Stadia MapsAlidade SmoothYesA modern, smooth-styled basemap.
Alidade Smooth DarkYesA modern dark-themed map.
Alidade SatelliteYesGlobal high-resolution satellite imagery.
OutdoorsYesMap style optimized for outdoor activities, hiking, and recreation.
Stamen TonerYesHigh-contrast, black-and-white style.
Stamen TerrainYesClassic terrain map with hill shading and elevation data.
Stamen WatercolorYesA unique, artistic map style with a watercolor look.
OSM BrightYesA general-purpose map style based on OpenStreetMap data.
MaptilerAquarelleYesA distinct, pale blue, watercolor-inspired map style.
BackdropYesA minimal basemap designed for data overlays.
BasicYesA clean and simple basemap.
BrightYesA lighter, colorful map style.
DatavizYesMap optimized specifically for displaying data layers.
LandscapeYesStyle focused on natural features and terrain.
OceanYesStyle highlighting ocean depths and coastlines.
OutdoorYesDetailed map for outdoor navigation.
SatelliteYesHigh-resolution satellite imagery.
StreetsYesDetailed urban and street map.
PastelYesSoft, color-muted map style.
TonerYesHigh-contrast black-and-white map style.
TopoYesTopographic map with elevation and terrain features.
WinterYesWinter-themed map style with distinct coloration.
LocationIQStreetsYesStandard street map from the LocationIQ service.
LightYesLight-themed basemap.
DarkYesDark-themed basemap.
ThunderforestTransport MapYesMap style emphasizing public transport routes.
LandscapeYesStyle focused on natural and terrain features.
OutdoorsYesMap optimized for outdoor activities and recreation.
OpenCycleMapYesMap focused on cycling routes and infrastructure.
CartoPositron (Light)YesA very popular, clean, light background map.
Dark Matter (Dark)YesA very popular, dark background map.
OtherWikimedia MapsNoOfficial map style from Wikimedia Foundation.
CaltopoYesTopographic map style (Note: Key required is based on API usage).
ÖpnvkarteNoMap style focused on public transit (ÖPNV).
OpenTopoMapNoTopographic map style with strong relief shading.
Custom (Enter URL) (XYZ/Vector)N/AAllows you to enter any external XYZ or Vector tileserver URL.

Changing your Tile Server #

Once you have selected your mapping engine/provider you can control the default tileserver all maps will use, from the service provider.

  1. Navigate to Maps > Settings > Advanced
  2. Change your selection for your Map Style (Or Tile Server URL for some engines)
  3. Optionally, if needed add a key for the server.
    • Not needed if you are using a preset like Azure Maps, Stadia Maps, Zero Cost, MapTiler, LocationIQ, as these use the engine key you provide during setup
  4. Save your settings

Customizing Tilesets Per Map #

Once you have selected a Provider, you have the flexibility to choose a specific Tileset for each individual map you create.

This is a powerful feature that allows you to:

  • Use a Satellite view for one map and a Road view for another, even if they share the same provider.
  • Create one map with a Dark map style, and another with a Light map style

Additionally, some tilesets contain multiple layers, which means you can allow users to switch between, for example, Satellite view and roadmap in realtime!

How to Change Tilesets for each map #

  1. Navigate to Maps > And edit your map
  2. Click on Settings > Themes > Tileset
  3. Select your preferred override tileset for this map
  4. Save the map to see the change

Want to dive deeper into the theme editor for Leaflet and Open Layers? Take a look at our theme documentation.

Applying Preset Filters to your tileset #

In some cases, you may want to apply a preset filter to the tileset for a unique look that aligns better with your needs.

  1. Navigate to Maps > Edit > And edit your map
  2. Click on Settings > Themes > Presets
  3. Select a preset that fits your needs
  4. Save your map

Want to dive deeper into the theme editor for Leaflet and Open Layers? Take a look at our theme documentation.

Customize Tilesets further #

If you find you need to adjust the tileset further, to better fit your branding or site colour scheme, you can use our map theme editor to adjust the tiles with our unique filter system.

  1. Navigate to Maps > Edit > And edit your map
  2. Click on Settings > Themes > Theme editor
  3. Adjust your filters as preferred
  4. Save your map

Want to dive deeper into the theme editor for Leaflet and Open Layers? Take a look at our theme documentation.

What about Google Maps? #

Google Maps does not use a tileserver system, and instead uses a unified tile system which you can control with styles, either locally or via the cloud.

You can learn more about this in our theme section.

Updated on April 15, 2026

What are your Feelings

  • Happy
  • Normal
  • Sad

Share This Article :

  • Facebook
  • X
  • LinkedIn
  • Pinterest
Table of Contents
  • Available Tile Servers
  • Changing your Tile Server
  • Customizing Tilesets Per Map
    • How to Change Tilesets for each map
    • Applying Preset Filters to your tileset
    • Customize Tilesets further
  • What about Google Maps?
Documentation by WP Go Maps