The Details View tab controls how a single result is displayed after users click into an entry.
It lets you choose between full page output and structured, field-based output, and map which target form fields appear in the details layout.
Screenshot placeholder: full Details View tab overview showing Details Page, Render Mode, and Structured Fields settings.
Configuring Details View
1. Details Page Settings
Details Mode defines where and how the single-entry detail view is rendered.
Details Page
Select the WordPress page used to display full details for a result entry.
This page should be used with the selected render mode settings and will be used as the destination for detail links from Search Results/Map marker outputs.
Render Mode
Choose one of the following:
Page Content: Display the content of the selected Details Page and merge entry data into the page content.
Structured Fields: Renders details from configured fields using the [gfgeo_search_entry_details] output area.
Render Mode depends on a selected Details Page.
If no page is selected, the Details View configuration cannot be applied for front-end detail rendering.
Screenshot placeholder: Details Page dropdown and Render Mode selector.
2. Details Structured Output
Structured output builds the details page content from selected target form fields.
Title Field
Optional field used as the details page title.
Leave empty to render no title.
Main Image Field
Optional image field used as the main visual for details.
Supports image fields, file upload fields, and other compatible image sources.
Details Fields
Configure additional output rows for the details page:
Source: Select a target form field or compatible metadata source.
Label Override: Optional custom label shown in the row.
Format: Text, Link, Link (New Tab), or Image.
Row order can be adjusted to match your intended detail layout.
Screenshot placeholder: Details Structured Output with Title Field, Main Image Field, and Details Fields repeater.
How Details View Works
Details Page defines the destination page for detail views. From there, Render Mode decides whether output uses full page content or structured rows.
In Structured Fields mode, details content is assembled from:
Title field
Optional main image
Configured details rows
This mode gives consistent, field-driven detail layouts without writing custom templates.
Page Content mode is ideal when you want complete control over the page layout using WordPress content, page builders, or custom page designs.
Tips for Setup
Always choose a Details Page before enabling Render Mode.
Use Structured Fields for stable admin-managed templates without custom code.
Use Page Content when you need a pre-designed layout and WordPress page-level control.
Set details output fields before generating or testing front-end detail links.
