Documentation

Dynamic Geolocation Field

Last modified: September 11, 2026

Introduction

The Dynamic Geolocation Field is a mode applied to a compatible native Gravity Forms field. It copies one selected value from a Gravity Geolocation source field into that native field as the source data changes.

Use it to expose a single address component, numeric distance, shape measurement, nearest-location property, or address-validation result for conditional logic, calculations, notifications, and other Gravity Forms workflows.

Supported Gravity Forms Fields

Dynamic Geolocation settings are available for Single Line Text, Paragraph Text, Number, Hidden, Dropdown, Multiple Choice, Checkboxes, and Address fields. Choose a destination field type appropriate for the value. For example, use a Number Field for a numeric distance used in calculations.

Dynamic Geolocation Field Options

Gravity geolocation Dynamic Field Options
Configuration options for a Dynamic Geolocation Field.

1. Field Usage

Select the kind of source data: Location, Directions, Distance, Drawing Tools, Drawing Shape, Nearest Locations, or Address Validation. Choose Disable to return the native field to normal behavior.

2. Source Field

Select the source Geocoder or feature field. Only source fields compatible with the selected usage appear.

3. Source Value

Select the individual property to copy. The available values change with the mode. Nearest Locations uses a text property name so it can return a built-in or custom destination value.

The Seven Dynamic Modes

1. Location

Gravity geolocation Dynamic Location Field
Location mode source and value settings.

Select a Geocoder Field and return one location property, including street components, city, county, region, postcode, country, place name, Place ID, formatted address, latitude, longitude, combined coordinates, or serialized location data.

2. Directions

Gravity geolocation Dynamic Directions Field
Directions mode source and value settings.

Select a Directions Field and return distance text, numeric distance, distance in meters, duration text, or duration in seconds.

3. Distance

Select a Distance & Duration Field and return the same distance or duration values available in Directions mode.

4. Drawing Tools

Select a Drawing Tools Field and return total area, total line length, total perimeter, collection bounds, shape count, shape types, label summary, or all shapes as serialized JSON.

5. Drawing Shape

Select a Drawing Shape Field and return its area, perimeter, line length, radius, center, bounds, label, fill color, shape mode, or geometry type.

6. Nearest Locations

Select a Nearest Locations Field and enter the property to return from the selected location. This can be a built-in property such as address, distance, or duration, or a custom column included in the destination data.

7. Address Validation

Select an Address Validation Field and return Status, Outcome, Delivery Status, Selected Address, Suggested Address, Selected Type, Region Code, or Geocoder ID.

Gravity Forms Calculation Example

To calculate a delivery fee from distance:

  1. Add and configure a Distance & Duration Field.
  2. Add a Gravity Forms Number Field.
  3. Set its Field Usage to Distance, choose the source field, and select Distance (value).
  4. Use that populated Number Field in another Gravity Forms calculation, such as distance multiplied by a per-mile rate.

The Dynamic Geolocation feature populates the source number; Gravity Forms performs the calculation.

How to Use Dynamic Geolocation Fields

  1. Add and configure the Gravity Geolocation source field.
  2. Add a supported native Gravity Forms destination field.
  3. Select the Dynamic Geolocation Field usage, source, and output value.
  4. Preview the form and trigger the source field.
  5. Confirm that the destination value updates and is saved with the entry.
menu-circle