🗺️ FacetWP Map Facet – Usage Instructions (v4.4 and Newer)

FacetWP v4.4 introduced a split in the Map facet functionality to give users flexibility while migrating to the new built-in version. You can now choose between two Map facet types:

1. Legacy Map Facet – Requires the separate Map facet add-on to function.

2. New Built-in Map Facet – Integrated directly into the main FacetWP plugin; the Map facet add-on should not be installed.

This change allows existing users to continue using the legacy version while optionally migrating to the new Map facet for improved performance and features. Migration is recommended but not mandatory.

⚙️ How to Switch to the FacetWP Map Facet

• Step 1: Ensure you are using FacetWP v4.4 or newer.

• Step 2: Remove the Map Facet add-on if it is installed.

• Step 3: Add a new Map facet through the main FacetWP plugin.

• Step 4: Configure your facet as needed and replace any legacy facet references in your templates or pages.

Note: Version 1.2 of the Map Facet add-on will be the last update; it will not receive future updates.

For more context about the Map and Proximity facet changes in v4.4 and why migrating is recommended, check the official release news article from FacetWP.

✅ Conclusion

The FacetWP Map facet in v4.4+ provides an upgraded, built-in solution for location-based filtering. By migrating from the legacy add-on to the new Map facet, users gain better integration, simplified management, and continued support. Following the above steps ensures a smooth transition while maintaining all existing filtering functionality.