Documentation

Mashup Map Shortcode

Last modified: September 11, 2026

Introduction

The Gravity Forms Mashup Map displays locations saved with multiple Gravity Forms entries on one interactive Google map. It reads location data from Geocoder Fields and creates a marker for each valid saved location.

Use the [gfgeo_mashup_map] shortcode on a post or page. This is a Gravity Geolocation Pro feature, and form_id is required.

Gravity Forms entries displayed on a Mashup Map
Multiple Gravity Forms entry locations displayed on one map.

Shortcode Attributes

1. form_id

Enter the Gravity Forms form ID whose entries should be displayed. This attribute is required (Example: form_id="1").


2. Entry Filters

include_entries

Limit the map to specific comma-separated entry IDs (Example: include_entries="101,102,103").

exclude_entries

Exclude specific comma-separated entry IDs (Example: exclude_entries="102"). Include and exclude filters can be combined; included entries that also appear in the exclusion list are omitted.


3. Geocoder and Information Window

geocoder_ids

Enter the Geocoder Field IDs to include, separated by commas. When omitted, all Geocoder Fields in the form are used (Example: geocoder_ids="1,4"). The older geocoders_id spelling remains available as a compatibility alias.

info_window_fields

Enter comma-separated saved location properties to show in each marker’s information window (Default: formatted_address) (Example: info_window_fields="place_name,formatted_address").


4. Map Size and View

map_height

Set the map height using a CSS size (Default: 400px).

map_width

Set the map width using a CSS size (Default: 100%).

map_type

Choose ROADMAP, SATELLITE, HYBRID, or TERRAIN (Default: ROADMAP).

zoom_level

Set the initial zoom level (Default: 12). The map may adjust its view to fit displayed locations.

gesture_handling

Set Google Maps gesture handling, such as auto, cooperative, greedy, or none (Default: auto).


5. Locations and Markers

max_locations

Set the maximum number of entry locations retrieved for the map (Default: 200).

marker_clusterer

Group nearby markers into clusters. Use 1 to enable or 0 to disable (Default: 1).

custom_marker_icons

Assign an icon URL to one or more Geocoder IDs using ID|URL. Separate IDs sharing one icon with semicolons and separate icon rules with commas (Example: custom_marker_icons="1;4|https://example.com/blue.png,7|https://example.com/red.png"). A URL without IDs becomes the default custom icon.


6. Compatibility Aliases

Older shortcodes continue to accept geocoders_id, info_window_content, max_entries, entries_count, results_count, map_markers, group_markers, marker_cluster, scrollwheel_zoom, and scroll_wheel. Use the preferred current attributes above for new shortcodes.

Shortcode Examples

Display up to 200 locations from form 1:

[gfgeo_mashup_map form_id="1"]

Show selected Geocoder Fields with custom information-window content:

[gfgeo_mashup_map form_id="1" geocoder_ids="1,4" info_window_fields="place_name,formatted_address"]

Limit entries, disable clustering, and use a custom marker:

[gfgeo_mashup_map form_id="1" include_entries="101,102,103" exclude_entries="102" max_locations="50" marker_clusterer="0" custom_marker_icons="1|https://example.com/marker.png"]

Customize the map view:

[gfgeo_mashup_map form_id="1" map_height="500px" map_width="100%" map_type="TERRAIN" zoom_level="10" gesture_handling="cooperative"]

Setting Up and Using the Mashup Map

  1. Confirm that the form contains at least one Geocoder Field and has entries with valid saved coordinates.
  2. Add the shortcode to a WordPress post or page and provide the required form_id.
  3. Add only the attributes needed for your map.
  4. Preview the page and confirm that the correct entries, markers, information windows, and clusters appear.
menu-circle