Markers Filter adds a powerful on-map filtering form for taxonomies and custom fields, with on-the-fly or manual apply modes and optional filter synchronization (cascading available options).
This is an Ultimate module. Enable under Ultimate Modules. It is a first-class part of Ultimate even though older marketing sites sometimes under-listed it.
When to use it
| Markers Filter | Alternatives |
|---|---|
| Filter markers without leaving the map | Core faceted search — lighter taxonomy-only UI |
| Mix taxonomies and custom fields | List & Filter sidebar — better for directory pages |
| Need on-the-fly + sync between filters | Advanced Search — separate form + redirect |
Add Markers Filter to a map
- Enable the module in Ultimate Modules.
- Edit your map → Progress Map settings → Markers filter Settings.
- Set Markers filter option to Yes.
- Choose display status (show/hide form on map load).
- Choose position and layout of the filtering form.
- Choose a filtering method (see below).
- Configure filters synchronizing if desired.
- Add taxonomies and/or custom fields to the filter.
- Save the map.
Show / hide on map load
- Show on map load — form open immediately (power-user directories)
- Hide on map load — visitors open it via the map button (cleaner first paint)
Position & layout
Pick where the form sits in the map chrome and which layout variant fits your theme width. Always test mobile: wide filter forms need stacking.
Filtering methods
Ultimate supports three approaches:
- On-The-Fly filtering — selecting an option filters immediately (no Apply click).
- Manual filtering — select options, then click Apply.
- Switchable filtering — visitors toggle on-the-fly vs manual with a switch on the form.
How to set it
In Filters Parameters → Filtering method, choose On-The-Fly, Manual, or Switchable, then save.
UX guidance: On-the-fly feels magical on small term lists; manual is safer when each change would trigger heavy queries.
Filters synchronizing
When Filters synchronizing is Yes, choosing a value in one filter updates the other filters so options that would yield zero results disappear (faceted cascading).
When No, all options stay visible even if combinations are empty.
Use sync on large catalogs to prevent dead-end searches; skip it if your meta options are small and sync feels jumpy.
Filter by taxonomies
Add the taxonomies registered for your map’s post type (categories, amenities, listing type, …). Order them by importance — first filter should be the primary facet of your business.
Filter by custom fields
Add meta-based filters (price, bedrooms, status flags, …). Field keys must match what your posts actually store. After bulk meta changes, re-test filters and clear caches.
Custom icons
Upload custom icons for filter UI elements where the module allows it — keep visual language consistent with map buttons and List & Filter icons.
Strings translation
Translate filter labels and UI strings via the module’s translation options, WPML, or PoEdit.
Troubleshooting
| Issue | Check |
|---|---|
| No filter button | Module off; option No on map |
| Apply does nothing | Manual mode without clicking Apply; JS errors |
| Empty after filter | Too strict combinations; query baseline already tiny |
| Sync removes everything | Data quality — terms not assigned to posts |
| Conflict | Standalone Markers Filter plugin still active |
