Documentation

Details Display Settings

Last modified: August 6, 2026

Introduction

The Details Display tab controls how an individual Target Form entry is displayed after a visitor
follows a details link from search results, a map info window, or another supported location.

Details Display supports three Output Modes:

  • Structured Fields
  • Custom HTML
  • Page Content

The Details Display tab controls the entry content and layout. The destination page and entry URL format are
configured separately under Search Setup → Details Routing.

Details Display tab in Gravity Search Settings

Before You Begin

Before configuring the entry output, open Search Setup → Details Routing and select a
published Details Page.

The Details Page is the WordPress page used as the destination for entry details links. Details Routing also
controls whether entry URLs use Pretty or Simple mode.

For complete routing and URL configuration instructions, see Details Routing in Search Setup Settings.

Shortcode Requirements

When using Structured Fields or Custom HTML, place the following shortcode on the
selected Details Page where the individual entry should appear:

[gfgeo_search_entry]

The shortcode is not required when using Page Content. In Page Content mode, the selected page
content becomes the entry template.

The Details Display Tab

Open the Details Display tab in Search Settings to select an Output Mode and configure the content displayed for individual entries.

1. Output Mode

The Output Mode setting determines how Gravity Search generates the individual entry display.

  • Structured Fields: Builds the entry display from selected Target Form fields and configurable display rows.
  • Custom HTML: Builds the entry display from custom HTML and supported Target Form merge tags.
  • Page Content: Uses the selected Details Page content as the entry template and resolves supported merge tags within that content.

Choose Structured Fields for configuration-based output, Custom HTML for direct control over the generated markup, or Page Content when the WordPress page itself should provide the entry layout.

Output Mode settings in the Details Display tab

2. Structured Fields

Select Structured Fields to build the individual entry display from selected fields and configurable rows.

The generated output appears where the [gfgeo_search_entry] shortcode is placed on the selected Details Page.

Title Field

Optionally select a Target Form field or supported entry value to display as the details title.

Leave this setting empty when no title should be displayed.

Main Image Field

Optionally select a compatible Target Form field to use as the primary image for the entry.

Details Fields

Add and arrange display rows containing Target Form fields, entry metadata, distance information, or other supported sources.

Each row contains the following settings:

  • Source: The field or entry value displayed by the row.
  • Label Override: An optional custom label used instead of the default field label.
  • Format: Display the value as Text, Link, Link (New Tab), or Image.

Use Add Row to add fields. Rows can be reordered or removed to create the desired entry layout.

Structured Fields settings in the Details Display tab

3. Custom HTML

Select Custom HTML to build the individual entry display using custom markup and supported merge tags.

The generated output appears where the [gfgeo_search_entry] shortcode is placed on the selected Details Page.

Details HTML

Enter the HTML used to render the individual entry.

Use the merge-tag selector to insert Target Form field values, entry properties, and other supported values into the template.

For example:

<article class="member-details">
	<h2>{Name:1}</h2>
	<p>{Email:2}</p>
</article>

Replace the example merge tags with the appropriate fields from your Target Form.

See Search Templates & Merge Tags for additional guidance.

Custom HTML settings in the Details Display tab

4. Page Content

Select Page Content to use the content of the selected Details Page as the individual entry template.

Add supported Gravity Forms merge tags directly to the WordPress page content. When an entry details URL is loaded, Gravity Search resolves those merge tags using the requested Target Form entry.

For example, the Details Page content might contain:

<h2>{Name:1}</h2>
<p>{Email:2}</p>

Do not add [gfgeo_search_entry] when using Page Content mode. The page content itself becomes the details output.

Page Content is useful when you want to build the complete entry layout with the WordPress editor. If a third-party page builder generates content outside the standard WordPress page content, test the completed page on the frontend to confirm that its merge tags and layout are processed as expected.

How Details Display Works

When a visitor follows a details link, Gravity Search identifies the requested Search and Target Form entry and
loads the Details Page selected under Search Setup → Details Routing.

The selected Output Mode then determines how the entry content is generated:

  • Structured Fields: Displays the configured title, main image, and details rows through the
    [gfgeo_search_entry] shortcode.
  • Custom HTML: Processes the configured Details HTML and displays it through the
    [gfgeo_search_entry] shortcode.
  • Page Content: Processes the selected Details Page content and resolves supported merge tags for
    the requested entry.

Details links can be enabled independently in Search Results and Map Info Window settings.

Setup Recipe

  1. Open Search Setup → Details Routing.
  2. Select a published Details Page.
  3. Configure the entry URL settings and save the Search.
  4. Open the Details Display tab.
  5. Select Structured Fields, Custom HTML, or Page Content under Output Mode.
  6. Configure the settings shown for the selected mode.
  7. For Structured Fields or Custom HTML, add [gfgeo_search_entry] to the selected Details Page.
  8. For Page Content, add the desired content and merge tags directly to the Details Page without the shortcode.
  9. Enable details links in Search Results or Map Info Window settings.
  10. Test an entry details link on the frontend.

Troubleshooting

The Details Page Opens but No Entry Is Displayed

  • Confirm that the correct Details Page is selected under Search Setup → Details Routing.
  • When using Structured Fields or Custom HTML, confirm that [gfgeo_search_entry] is present on that
    page.
  • Confirm that the requested Entry ID exists in the selected Target Form.
  • Verify that the Search and entry information is present in the details URL.

Merge Tags Appear as Plain Text

  • Confirm that Output Mode is set to Page Content when merge tags are placed directly in the
    Details Page content.
  • Confirm that the merge tags reference fields in the Search’s Target Form.
  • Open the page through a generated details link so Gravity Search has the required Search and entry context.

A Details URL Returns a 404 Error

  • Confirm that the selected Details Page exists and is published.
  • Confirm that the Search URL Slug and URL Structure settings are correct.
  • Verify that the URL contains a valid Entry ID.
  • After changing the WordPress permalink structure, open Settings → Permalinks and save the
    settings to refresh rewrite rules.

Details Links Are Not Displayed

Selecting a Details Page does not automatically add a details link to every output. Enable the appropriate
details-link setting under Search Results or Map Info Window settings.

menu-circle