Ninja Geolocation

Enhance Ninja Forms with powerful geolocation features like address autocomplete, coordinates, maps, and directions—ideal for businesses relying on precise location data.

Geolocation For Ninja Forms

The Complete Geolocation Solution for Ninja Forms

Ninja Geolocation transforms Ninja Forms into a powerful location platform for collecting addresses, displaying interactive maps, validating locations, calculating distance and travel time, and building advanced location-aware workflows with Google Maps Platform.

Build delivery forms, service requests, travel calculators, property forms, event registrations, field-service workflows, and more—without developing a custom geolocation integration.


Everything You Need for Location-Aware Forms

Ninja Geolocation provides native Ninja Forms fields and tools for location collection, mapping, routing, validation, and advanced location workflows. Available features depend on the Ninja Geolocation plan you choose.

Geolocation Fields

  • Geocoder Field – Geocode locations and keep connected address, coordinates, and map fields synchronized.
  • Address Field – Add Google-powered address autocomplete and location lookup.
  • Coordinates Field – Capture precise latitude and longitude coordinates.
  • Map Field – Let users select and refine locations on an interactive Google Map.
  • Locator Button – Detect and use the visitor's current location.
  • Reset Location Button – Clear a connected location and its associated fields.
  • Dynamic Location Field Options – Populate compatible native Ninja Forms fields with addresses, coordinates, distances, durations, and other location data.

Maps and Submission Visualization

  • Single Entry Maps – Display the saved location from an individual Ninja Forms submission.
  • Entries Mashup Maps – Combine locations from multiple submissions on one interactive map.
  • Custom Markers – Configure marker icons and map presentation.
  • Marker Clustering – Group nearby markers on maps containing multiple locations.
  • Static Maps – Display lightweight map images in supported entry and notification output.

Multiple Ninja Forms submission locations displayed on an entries mashup map
Display locations from multiple Ninja Forms submissions on an interactive mashup map.

Advanced Location Features

  • Address Validation – Verify, review, and standardize addresses before they enter your workflow.
  • Distance & Duration – Calculate route-based or straight-line distance and estimated travel time.
  • Routes & Directions – Display interactive routes and turn-by-turn directions, with support for waypoints and travel preferences.
  • Nearest Locations – Find and select the closest configured store, office, pickup point, or destination.
  • Drawing Tools & Shape Fields – Draw or preload service areas, delivery zones, property boundaries, and custom map regions.
  • Field Synchronization – Keep connected addresses, coordinates, maps, routes, and other location fields synchronized.
  • Dynamic Location Data – Send calculated and selected location values into compatible Ninja Forms fields, calculations, and workflows.

Address Validation field reviewing and standardizing an address in Ninja Forms
Review an address and apply a standardized suggestion inside the form.

Drawing Tools field used to create custom shapes on a Ninja Forms map
Create service areas, delivery zones, boundaries, and other custom map shapes.

Nearest Locations field displaying nearby destinations in Ninja Forms
Find and display the closest matching destinations based on the user's location.

Choose the Right Ninja Geolocation Plan

  • Starter — Core Location Collection: Geocoder, Address, Coordinates, Map, Locator, Reset, and dynamic location tools for one site.
  • Pro — Advanced Routing & Mapping: Everything in Starter, plus Address Validation, Distance & Duration, Directions, Directions Panel, and submission maps for three sites.
  • Agency — Complete Geolocation Suite: Everything in Pro, plus Nearest Locations and Drawing tools for twenty sites.

Compare all Ninja Geolocation plans and features.


Smart Location Workflows

Ninja Geolocation goes beyond collecting addresses. Its fields can work together to create practical location-aware experiences and automate the flow of location data through your forms.

  • Delivery & Service Areas – Validate destinations, calculate travel distance, and collect service-area information.
  • Travel & Pricing Calculations – Use distance and duration values in delivery fees, travel costs, quotes, and other calculations.
  • Current Location Detection – Let visitors use their current location instead of entering it manually.
  • Location-Based Automation – Populate fields and use location values with calculations, conditional logic, notifications, and custom workflows.
  • Accurate Address Collection – Improve address entry with Places API (New) autocomplete and optional Address Validation.
  • Interactive Maps – Let users select, refine, and visualize locations directly on Google Maps.

Popular Use Cases

  • Delivery and Logistics Forms
  • Service Request Forms
  • Property and Inspection Forms
  • Travel and Booking Forms
  • Event Registration Forms
  • Field Service Workflows
  • Lead Qualification Forms
  • Store, Office, and Pickup-Point Selection

Why Choose Ninja Geolocation?

  • Native Ninja Forms integration — Add and configure location fields through the familiar Ninja Forms builder.
  • Powered by Google Maps Platform — Use modern mapping, autocomplete, geocoding, routing, and address-validation services.
  • Flexible feature packages — Start with location collection and add routing, submission maps, nearest-location workflows, or drawing tools as needed.
  • Highly configurable — Customize fields, maps, calculations, output, and connections between location components.
  • Built for site owners and developers — Configure common workflows without custom development and extend advanced implementations with developer tools.
  • Works with existing Ninja Forms — Add geolocation features to forms without replacing your form builder.

Learn More About Ninja Geolocation

Visit the official Ninja Geolocation website to explore live demos, documentation, feature overviews, pricing, and setup guides.


Frequently Asked Questions

What can I build with Ninja Geolocation?

Ninja Geolocation can be used for delivery forms, service requests, travel calculations, property and inspection forms, event registrations, field-service workflows, nearest-location selection, and many other location-aware Ninja Forms applications.

Do I need Google Maps Platform API keys?

Yes. Ninja Geolocation uses separate Browser and Server API keys. The exact Google services required depend on the features used, but commonly include Maps JavaScript API, Places API (New), Geocoding API, Routes API, Address Validation API, and Maps Static API.

Can I calculate travel distance and directions?

Yes. The Pro and Agency plans include dedicated Distance & Duration and Directions fields for calculating travel distance, estimated travel time, route information, and turn-by-turn directions.

Can I display submitted locations on a map?

Yes. Pro and Agency include shortcodes for displaying an individual Ninja Forms submission on a Single Entry Map or combining multiple submissions on an Entries Mashup Map.

Does Ninja Geolocation support address validation?

Yes. Pro and Agency include an Address Validation field that uses Google's Address Validation API to review and standardize addresses.

Can I find the nearest location automatically?

Yes. The Agency plan includes Nearest Locations for comparing configured destinations using radius, driving distance, or travel time and selecting the closest matching location.

Does the plugin work with every Ninja Forms license level?

Yes. Ninja Geolocation works with Ninja Forms regardless of the Ninja Forms license level. The geolocation features available to you are determined by your Ninja Geolocation plan.

Get This Plugin

For pricing details and to purchase, visit the plugin’s official pricing page.

View Pricing & Purchase
Changelog

3.6.1 - 10/17/2026

  • New: Added a dedicated product dashboard with an overview, license and update controls, package comparison, help, and related plugins.
  • Improvement: Refined dashboard navigation, placed Open Settings first in the header actions, aligned related-plugin buttons, and moved admin notices below the navigation.
  • New: Added separate Starter and Pro products while preserving existing legacy packages, feature sets, settings, and license storage.
  • Compatibility: Added safeguards to prevent multiple Ninja Geolocation editions from loading at the same time, with independent license storage for the new standalone products.
  • Improvement: Updated Connect integration to identify the new Starter and Pro products separately while retaining the existing legacy product identity.
  • Fix: Prevented geolocation initialization conflicts when another plugin loads a separate Backbone Radio instance by using Ninja Forms’ native event bus.
  • Maintenance: Updated the bundled WPGeo Framework to 1.0.0-rc.17, Licensing SDK to 0.1.2, and Connect SDK to 0.1.3, with independent SDK runtime selection.

3.6.0 - 10/3/2026

  • Read the Ninja Geolocation 3.6 release post.
  • New: Added Quick Setups for Location & Map, Distance & Travel Time, Directions & Route, and Nearby Locations through Ninja’s native builder drawer.
  • New: Added native Ninja Forms templates for Location & Map, Distance & Travel Time, and Directions & Route.
  • New: Added field connection summaries and create-and-connect actions for supporting geolocation fields, with field navigation and undo support.
  • New: Added optional estimated pricing to Distance and Directions Quick Setups using native calculations and connected Number fields populated with meters and seconds.
  • Improvement: Added inline, separate-panel, and disabled output options for Directions and Nearby Locations, with independent route summary and turn-by-turn display settings.
  • Improvement: Added numeric distance and duration merge tags for actions and notifications. Native calculations use connected Number fields rather than these merge tags directly.
  • Improvement: New Directions fields calculate automatically when locations change. Existing saved trigger settings remain unchanged.
  • Improvement: Kept unavailable Quick Setups visible with Ninja’s native upgrade dialog, clarified empty field selectors, and separated Directions map settings from route-detail output settings.
  • Compatibility: Updated Dynamic travel value keys while preserving existing saved selections and legacy Directions and Nearby panel output.
  • Fix: Updated connection notices immediately when field selections change, and synchronized inline output and connected numeric values during updates and clearing.
  • Fix: New Directions fields no longer avoid ferries, highways, or tolls by default. Existing saved preferences remain unchanged.
  • Security: Hardened legacy geolocation value decoding to reject serialized objects while preserving supported location-array formats.
  • Dependency: Updated the embedded WPGeo Framework to 1.0.0-rc10, the minimum compatible shared runtime for this release.

3.5.0 - 9/29/2026

  • Read the Ninja Geolocation 3.5 release post.
  • Major: Completely rebuilt Ninja Geolocation on the shared WPGeo Framework.
  • New: Added Address Validation, Distance and Duration, Directions, Nearest Locations, drawing tools, and submission maps.
  • New: Added support for Places API (New), Routes API, modern maps, Ninja Forms repeaters, and dynamically populated location data.
  • Improvement: Added automatic migration for legacy settings, forms, fields, repeaters, licenses, and stored geolocation values.
  • Improvement: Added the WPGeo Dashboard, connected-account installation, and improved license management.
  • Compatibility: Preserved legacy Geocoder, Map, and Directions submission output. Directions Panel output is now handled by the Directions field.
  • Packaging: Consolidated legacy Personal and Business downloads into the Pro package while preserving existing license entitlements.
  • Fix: Improved standalone submission-map initialization, mixed form and map runtime data, and Address field behavior inside repeaters.
  • Dependency: Requires Ninja Forms 3.13.2 or newer.
  • Dependency: Includes WPGeo Framework 1.0.0-rc8 and EDD Software Licensing SDK 1.0.4.

3.1.1 - 7/9/2024

  • Fix: Fixed an issue where dragging a map marker cleared the address field even when the “Disable address output” checkbox was checked.
  • Tweak: Added a short delay before loading geolocation fields when moving between form parts to allow the fields to load properly.
  • Tweak: Verified that a geolocation field exists before trying to set its value.
  • Tweak: Added a short delay before panning multiple markers on a map.
  • Tweak: Declared variables with var to prevent JavaScript errors.
  • Tweak: Updated geocoder status when retrieving place details.
  • Tweak: Improved how geolocation repeater fields are collected.
  • Tweak: Removed unwanted debugging scripts.
  • Tweak: Improved the geocoder’s hidden submission fields.
  • Tweak: Improved the Map field’s HTML output.
  • Tweak: Passed the $field object to the geocoder field’s get_geocoded_data_output() method and nfgeo_geocoder_field_fields_output filter.

3.1.0.1 - 11/24/2021

  • Fix: Fixed a PHP error affecting some PHP versions.
  • Fix: Restored the missing Geocoder ID option in the Address field.

3.1 - 11/19/2021

  • Important: Some geolocation field values need to be updated in the database. Navigate to the Ninja Forms settings page and, under the Geolocation section, click “Update geolocation fields” if the button is available.
  • New: Added support for displaying multiple forms in a single mashup map. Pass multiple form IDs to the new forms_id or existing form_id shortcode attribute.
  • Fix: Resolved a conflict with Ninja Forms’ new Submissions page. Some geolocation fields are excluded from the new Submissions form; those fields remain available on the submission post page or through the Legacy Submissions page.
  • Fix: Prevented a JavaScript error by verifying that the Map field exists before trying to display it.
  • Tweak: Coordinates are now saved as comma-separated values rather than an array in the database.
  • Tweak: Updated links to the Ninja Geolocation website and support page.
  • Tweak: Increased the address autocomplete suggestions box’s z-index to prevent it from appearing underneath other elements.
  • Tweak: Removed the white cover displayed while geolocation was processing.
  • Tweak: Improved the Address field’s locator button and loading indicator, which now use SVG files.
  • Tweak: Verified that the current screen is the Ninja Forms settings page before loading Ninja Geolocation settings.
  • Tweak: Added the “Update Geolocation Fields” settings button to update supported geolocation field values in the database.
  • Maintenance: Renamed several files.
  • Maintenance: Applied various minor bug fixes and improvements.
  • Maintenance: Added a changelog file to the plugin.

3.0 - 7/18/2021

  • Initial release.