Documentation

Geolocation Fields Overview

Last modified: February 26, 2025

Introduction

The WPForms Geolocation plugin brings advanced geolocation features to your forms, enabling seamless address, map, and location-based inputs.
Once installed and activated, it adds geolocation-specific fields to the WPForms editor, which you can place anywhere in your form.

WPForms Geolocation Fields

WPForms Geolocation provides a variety of fields, each tailored to a specific geolocation functionality:

Geolocation field buttons
Geolocation-specific fields in the WPForms editor.
  • Geocoder: This hidden field is essential for syncing and processing geolocation data, ensuring smooth communication between other geolocation fields.
  • Address: Allows users to input addresses, which are geocoded and synced with other geolocation fields for seamless interaction.
  • Coordinates: Enables users to enter latitude and longitude values that can be reverse-geocoded or synchronized with other fields.
  • Google Map: Displays an interactive map where users can select or drag a marker to set their location.
  • Locator Button: Allows users to detect their current location via browser geolocation or IP-based services.
  • Directions: Calculates driving directions or straight-line distances between two locations.
  • Directions Panel: Displays detailed driving directions when paired with the Directions Field.
  • Reset Location: Clears data from geolocation fields and resets them to their default state.

Synchronizing Geolocation Fields

To ensure smooth communication between Geolocation fields, you must sync them using a Geocoder Field. Syncing ensures effective interaction between fields. For example:

  • When a user enters an address in the Address Field, the map marker moves to the corresponding location on the map.
  • Dragging the map marker to a new location updates the Address Field with the corresponding address.

Syncing is fundamental to the plugin’s geolocation functionality, ensuring accurate and dynamic field interactions.
Learn more about syncing Geolocation Fields.

How to Use Geolocation Fields

Follow these steps to configure and optimize Geolocation Fields in WPForms Geolocation:

  1. Add Geolocation Fields: Drag and drop the fields into your form.
  2. Sync Fields: Use the Geocoder Field to ensure proper synchronization between geolocation fields.
  3. Customize Options: Configure each field's settings to meet your geolocation needs.
  4. Test the Form: Preview the form to verify geolocation functionality, including address input, map interactions, and field synchronization.
menu-circle