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 Features
  • Filtering
  • Marker Filtering

Marker Filtering

3 min read

Overview #

This article covers how to set up various types of marker filtering. There are currently three forms of marker filtering that can be used in separately or integrated with any of the other options

  1. Store Locator
  2. Category Filtering
  3. Custom Field Filtering

Prerequisites #

The Following Plugin/s need to be installed and active

  • WP Go Maps
  • WP Go Maps Pro Add-on (optional, but required category or custom field filtering)

Store locator #

The Store locator is a type of filter that allows a user to pick an address and a radius, this results is a filtered set of markers that meet those criteria

For More information regarding setting up your store locator Please see our Store Locator guide.

Integrating the Store locator feature with other filtering types will be covered in the sections below.

Category Filtering #

Marker Categorization can be used with both the Store Locator and the Marker listing

Category Setup #

Categories must be first be setup for your maps/markers. Categories can be created at

WP Go Maps -> Categories

Category Settings #

The Category Filter Behaviour can be controlled by navigating to:

WP GO Maps -> Settings -> Categories

Category filter settings

Category filter settings

We currently support 2 types of category presentation Dropdown or Checkboxes.

  • Dropdown filtering allows the end user to pick one category to filter on
  • Checkboxes allows the end user to pick multiple categories to filter on, with a choice of filtering logic

Category Selection logic #

When using Checkboxes, 2 types of filtering logic can be used

  • OR (default) – when the end user selects more than one filter to filter on, markers that belong to any of the selected categories will be displayed
  • AND – when the end users selects more than one filter to filter on, only markers that belong to all of the selected categories will be displayed

Use Category Filtering with your Store Locator #

To enable the Category filter on the Store locator, please navigate as follows:

WP Go Maps -> Maps (edit your chosen map) -> Settings -> Store Locator -> Advanced -> Allow Category selection

Category filter with Store Locator

Category filter with Store Locator

Use Category Filter with your Marker listing #

To enable the Category filter on the marker listing, please navigate as follows:

WP Go Maps -> maps (edit your chosen map) -> Settings -> Marker Listing -> Filtering -> Category Filter

Note: To ensure accurate filtering the Marker Listing category filter should not be used at the same time as the Store Locator Category filter

Custom Field Filtering #

Custom Field Setup #

To use custom field filtering you would first need to set up some custom fields. Custom fields can be setup by navigating to:

WP Go Maps -> Marker Fields

If you intend filter by custom field, please ensure you select a Filter Type so the plugin knows how to present filtering controls to the end user

Creating a custom field and selecting the filter type

Creating a custom field and selecting the filter type

Enabling Custom Field Filtering #

To enable custom field filters for your map, please navigate to:

WP Go Maps -> Maps (edit your chosen map) -> Settings -> Marker Fields -> Select the checkbox of the fields you would like to filter.

Enabling Custom Field Filtering

Enabling Custom Field Filtering

Please ensure Custom field data has been added to your markers for the filter to work correctly

The Custom Field Filter can be used in conjunction with the other filtering options (Store locator and category filters)

Updated on January 14, 2025

What are your Feelings

  • Happy
  • Normal
  • Sad

Share This Article :

  • Facebook
  • X
  • LinkedIn
  • Pinterest
Table of Contents
  • Overview
    • Prerequisites
  • Store locator
  • Category Filtering
    • Category Setup
    • Category Settings
    • Category Selection logic
    • Use Category Filtering with your Store Locator
    • Use Category Filter with your Marker listing
  • Custom Field Filtering
    • Custom Field Setup
    • Enabling Custom Field Filtering
Documentation by WP Go Maps