Search Results Settings

1. Results Mode

Results Mode controls the overall appearance and rendering method used for search results.

Results Template

Select the template used to render search results on the front-end.

Results Layout

Choose the default layout used when displaying results.

• Grid: Display entries using a card-based grid layout.
• List: Display entries in a traditional vertical list.

Layout Toggle

Allow visitors to switch between Grid and List layouts directly from the results toolbar.

Render Mode

Choose how result items are rendered.

• Structured Fields: Build result layouts using selected fields and display settings.
• Custom Template: Render results using custom template markup.

Structured Fields is ideal for most projects, while Custom Template provides complete control over the output.

2. Structured Fields

Structured Fields mode allows you to build result layouts using selected Target Form fields.

Title Field

Select the Target Form field used as the result title.

Link Title to Details Page

Link the result title directly to the Details Page for the entry.

Main Image Field

Select the image field displayed as the primary image for each result.

Distance Display

Display the calculated distance for each result when proximity search is enabled.

Details Link

Display a dedicated Details Page link and customize the link label.

Details Link Label

Customize the text displayed for the Details Page link.

Default value: View Details.

Result Details

Configure additional rows displayed for each result item. Each row can display Target Form fields, entry metadata, distance information, and details page links.

For each row you can configure:

• Source: The field or data source to display.
• Label: Optional custom label.
• Format: Text, Link, Link (New Tab), or Image.

Rows can be added, removed, and reordered to create custom result layouts.

3. Custom Output

Custom Output mode provides complete control over how result items are rendered on the front-end.

Table Head Template

Define custom table header markup when using table-style result templates.

Result Item Template

Create fully customized result layouts using HTML, CSS, Gravity Forms merge tags, and Gravity Search merge tags. The template editor allows you to define the markup used for every result item displayed on the page.

Use the Insert Merge Tag button to quickly insert Target Form fields, entry metadata, distance values, details page URLs, and other supported data into your template. Custom Output mode is ideal when Structured Fields output is not flexible enough for your design requirements.

Learn more about available merge tags and custom output templates in Search Templates & Merge Tags.

4. Results Controls

Results Controls determine which toolbar options are available to visitors.

Per Page Options

Configure the available results-per-page options shown in the toolbar.

Example:

10,20,50,100

Visitors can choose how many results are displayed at a time.

Sort Options

Configure the sorting options available to visitors. Each sort option consists of a label, sort field, and sort direction.

Common sorting options include:

• Newest
• Oldest
• Entry ID (Highest)
• Entry ID (Lowest)
• Distance (Nearest)
• Distance (Farthest)

Custom sorting options can also be created using Target Form fields.

5. Pagination

Configure how visitors navigate through multiple pages of search results.

Pagination Mode

Choose how additional results are loaded on the front-end.

• Pagination: Display traditional page numbers and navigation controls.
• Load More: Display a button that loads additional results without navigating to another page.

Load More Button Text

This setting is only available when Pagination Mode is set to Load More.

Customize the label displayed on the Load More button when using Load More pagination mode. Load More mode is useful when displaying long result lists without requiring visitors to navigate between pages.

6. No Results

Configure the message displayed when a search returns no matching results.

No Results Text

Enter custom text displayed when no entries match the current search criteria.

This can be used to provide helpful instructions or encourage users to broaden their search.