Documentation

Gravity Search Overview

Last modified: June 23, 2026

Introduction

Gravity Search transforms Gravity Forms into a powerful search and directory platform. Using a dedicated Search Form, users can search, filter, sort, and display entries submitted through another Gravity Form, known as the Target Form.

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 Full Search Form

How Gravity Search Works

Gravity Search uses two separate forms:

  • Target Form: The form that stores entries and data.
  • Search Form: The form used to search, filter, and display entries from the Target Form.

Users create a Search Form, connect it to a Target Form, add search fields using the standard Gravity Forms builder, and then configure how results are displayed using the Search Settings page.

When a search is performed, Gravity Search queries entries stored in the Target Form and can optionally perform proximity searches against one or more geocoded location sources stored with each entry.

Gravity Search Target Form Picker

Key Components

1. Search Forms

Dedicated Gravity Forms used to search entries stored in a Target Form. Search Forms are built using the standard Gravity Forms builder and can use common field types such as text fields, dropdowns, checkboxes, dates, and more as search filters.


2. Target Forms

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


3. Location Data Sources

Target Form entries can contain one or multiple geocoded location sources. Gravity Search allows you to choose which of these locations are used when performing 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 output, and custom templates.


5. Maps

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


6. Details View

Display complete information for individual entries using customizable layouts and templates.

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

Next Steps

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

menu-circle