Description
Add Google-powered address suggestions to Ninja Forms. Use the included single-line Address field to help visitors enter addresses with less typing.
Features
- Dedicated single-line Address field in the native Ninja Forms builder.
- Country restrictions: up to five countries per field.
- Result types: regions, cities, street addresses or premises.
- Per-field suggestion language.
- Global language and region preferences.
- Location bias by point and radius or rectangular bounds.
- Optional restriction to rectangular bounds.
- Required suggestion selection with a custom alert message.
- Saves addresses through Ninja Forms’ normal submission lifecycle.
An Address field built for Ninja Forms
Add the Address field from the Geolocation field group and configure autocomplete in its field settings. The plugin collects a complete address in one input; it does not fill Ninja Forms’ separate street, city, state, ZIP or country fields.
Customize suggestions
Choose countries, result types and language for each field. Prioritize suggestions near a point or within map bounds, or restrict results to those bounds. The global region preference influences results; country restrictions limit which countries can appear.
Require a suggestion selection
Optionally require visitors to choose an address suggestion. Manually typed, unselected text is cleared, and your custom alert prompts them to select a suggestion. This is not postal address validation or a deliverability guarantee.
Google API requirements
A Google Maps API key is required for address autocomplete to work. Follow this tutorial to create your Google Maps API key.
Google Maps Platform terms | Google privacy policy
Need more than autocomplete?
Ninja Geolocation offers paid packages for interactive maps, geocoding, dynamic location fields, current-location detection, directions, distance calculations, address validation, nearby locations and drawing tools. Feature availability depends on the package.
Ninja Geolocation is a separate plugin, not functionality unlocked inside this free plugin by entering a license.
Explore packages and pricing | Try the live demos | Read the documentation
Installation
- Install and activate Ninja Forms 3.13.2 or newer.
- Install and activate Logical Address Autocomplete for Ninja Forms. Deactivate Ninja Geolocation first if you are switching to this free plugin.
- Open Ninja Forms > Settings and find the Address Autocomplete section.
- Enter your Google Maps API key with Maps JavaScript API and Places API (New) enabled.
- Set optional global region and language preferences.
- Open your form in the Ninja Forms builder and add the Address field from the Geolocation group. Configure its options and save.
- Preview and test selecting suggestions and submitting the form.
The overview is available under Ninja Forms > Address Autocomplete. If Ninja Forms is unavailable, it appears under Settings > Address Autocomplete instead.
FAQ
Which fields support address autocomplete?
You can enable address autocomplete on the plugin’s dedicated single-line Address field in Ninja Forms.
Are all the autocomplete controls included free?
Yes! All the address autocomplete controls described above are included in the free plugin.
Can I customize the address suggestions?
Yes! You can limit suggestions to selected countries, choose the types of places to suggest, and prioritize suggestions around a location or area. You can also set a default language and choose a different language for individual fields.
Can I require visitors to select an address suggestion?
Yes! You can require visitors to choose an address from the suggestions and customize the message that guides them to make a selection. Visitors can retry after unselected text is cleared, or enter addresses manually when this option is off.
Can I use it on AJAX or multi-page forms?
Yes! Address autocomplete supports AJAX rendering and dynamically displayed Address fields. Multi-page and conditional forms use the corresponding Ninja Forms features or add-ons.
Does this validate postal addresses or provide maps and directions?
Autocomplete helps visitors choose a Google address suggestion. Postal address validation, connected maps, directions and current-location detection are available through separate paid Ninja Geolocation packages.
How do I switch to the premium plugin?
Deactivate the free plugin when switching to Ninja Geolocation. Your saved fields and settings stay in place. If both are active, the free plugin pauses its integrations and shows an administrator notice.
Is a plugin account or license required?
You can use the plugin without creating a plugin account or buying a license. You’ll need your own Google Cloud account and browser API key for Google’s address suggestions.
Can another integration load Google?
Yes! Developers can use the nfgeo_disable_google_maps_api filter to let another integration load a compatible Google Maps JavaScript API with Places support.
Where can developers find the source code?
Readable JavaScript and SCSS sources are included in the plugin. The full development project, build configuration and dependency lockfile are available on GitHub. To rebuild assets, download the repository, install Node.js/npm, then run npm ci and npm run build (esbuild and Sass). These tools are not required to use the plugin.
Includes Choices.js 11.1.0, MIT licensed; readable distribution: assets/js/editor/vendor/choices.js; license: assets/licenses/choices.txt.
Screenshots




Changelog
1.0.1
- Renamed the plugin to Logical Address Autocomplete for Ninja Forms. The existing plugin slug and saved settings are unchanged.
- Refreshed the overview navigation and action buttons, aligned discovery-card buttons, and placed admin notices below the navigation.
- Updated the package comparison to Address Autocomplete, Starter and Pro, including the complete Pro feature set.
- Organized the overview into a contained dashboard folder without changing autocomplete behavior.
1.0.0
- Initial release.
