Documentation

Gravity Search Overview

Last modified: August 6, 2026

Introduction

Gravity Search transforms Gravity Forms into a powerful search and directory platform. A Search connects to a separate Gravity Form, known as the Target Form, and can display its entries through optional filter controls, customizable results, maps, and individual entry views.

Gravity Search supports text-based searches, advanced filters, proximity searches, interactive maps, customizable results layouts, and detailed entry views. Whether you're building a business directory, property finder, event search, member directory, or store locator, Gravity Search provides the tools needed to create a complete search experience directly inside Gravity Forms.

Gravity Search complete search experience

How Gravity Search Works

Gravity Search connects two core components:

  • Target Form: The Gravity Form that stores the entries and data being searched.
  • Search: The configured search experience that queries, filters, and displays entries from the Target Form. A Search can include optional visitor-facing search fields, results, a map, and individual entry views.

Create a Search, connect it to a Target Form, optionally add visitor-facing search fields using the standard Gravity Forms builder, and then configure its behavior and display using Search Settings.

When a Search runs, Gravity Search queries entries stored in the Target Form. It can also perform proximity searches against one or more geocoded locations stored with each entry.

Gravity Search Target Form Picker

Key Components

1. Searches

Configured Gravity Search experiences that retrieve entries from a Target Form. Each Search is built on a dedicated Gravity Form and can include optional visitor-facing fields such as text inputs, dropdowns, checkboxes, dates, and location controls.


2. Target Forms

The Gravity Form containing the entries and data being searched. A single Target Form can be used by multiple Searches, each providing a different search experience while using the same underlying dataset.


3. Location Data Sources

Target Form entries can contain one or more geocoded location sources. Gravity Search allows you to choose which locations are used for proximity searches, distance calculations, and map-based searches.


4. Search Results

Display matching entries using customizable layouts with support for sorting, pagination, result controls, structured fields, and custom HTML.


5. Maps

Display matching entries on interactive Google Maps with markers, clustering, info windows, and proximity search support.


6. Details Routing

Select the WordPress page used for individual entries and configure their URL format using Pretty or Simple URLs.


7. Details Display

Display complete information for individual entries using Structured Fields, Custom HTML, or Page Content with merge tags.

Common Use Cases

Gravity Search can be used to build many types of searchable applications and directories:

  • Business Directories
  • Store Locators
  • Property Listings
  • Member Directories
  • Event Search & Listings
  • Resource Libraries
  • Service Provider Directories
  • Location Finders
Gravity Search flexible results and map layout

Next Steps

Ready to build your first Gravity Search experience? Continue with the following guides:

menu-circle