Documentation

Settings Up Geolocation For Ninja Forms

Last modified: March 16, 2025

Introduction

The Geolocation for Ninja Forms plugin brings advanced geolocation capabilities to your Ninja Forms, enabling location-based fields, address autocomplete, and interactive maps. The General Settings page includes essential options for configuring API keys, geolocation methods, and advanced settings to fine-tune the plugin’s performance.

These settings ensure smooth integration with Google Maps services, allowing for accurate location detection and seamless handling of geolocation data within your Ninja Forms.

Geolocation for Ninja Forms General Settings

Navigate to Dashboard > Ninja Forms > Settings > Geolocation section to access the plugin’s settings.

Ninja Forms Geolocation Settings Page
Setting available for Ninja Forms Geolocation.

1. License Key

Enter your Geolocation for Ninja Forms license key to activate the plugin and receive updates and support. The plugin will continue functioning with an expired license, but updates and support will no longer be available.

How to Retrieve and Enter Your License Key

2. Google Maps API Keys

Google Maps API keys are required to enable mapping and geolocation features in Ninja Forms.

Browser API Key

Enter your Google Maps Client (Browser) API Key. This key allows interaction with Google Maps services for front-end features such as address autocomplete and map display.

Server API Key

Enter your Google Maps Server API Key for server-side geolocation operations, such as geocoding and reverse geocoding.

Note: If you don’t have API keys yet, create them here. For step-by-step instructions, follow this guide.

3. Default Country Code

Specify the country code to use as the default for Google Maps Geocoding services. Refer to this country code list (Default: US).

4. Google Maps Language

Choose the default language for Google Maps API. This setting affects map interface text and autocomplete suggestions. See this list of language codes (Default: EN).

5. High Accuracy Location Mode

Enable this option to use HTML5 geolocation for more precise location detection. This method may take slightly longer, as it relies on the user's browser permissions and device sensors.

Note: This setting does not impact IP-based geolocation.

6. IP Address Settings

Select a third-party IP provider for IP-based geolocation, which serves as an alternative or fallback when users deny HTML5 geolocation.

Supported IP Providers

  • ipinfo.io: Requires registration and a token.
  • Ipregistry: Requires registration and an API key.
  • Ipapi.co: No registration needed for the free plan but available with other plans.

7. Advanced Settings

Disable Google Maps API

Enable this option if another plugin or theme on your site already loads the Google Maps API, preventing duplicate loading issues.

How to Use These Options

Follow these steps to configure the General Settings:

  1. Activate the License: Enter and verify your license key.
  2. Set API Keys: Add both the Browser and Server API keys.
  3. Configure Geocoder Settings: Set a default country code and language.
  4. Enable High Accuracy Mode: Improves location precision using HTML5 geolocation.
  5. Set Up IP-Based Geolocation: Choose a provider and enter the required credentials.
  6. Adjust Advanced Settings: Enable or disable features based on your needs.
menu-circle