These docs are a work in progress and may not be fully up to date. Some pages may contain internal notes for our team.
Skip to Content
FeaturesContent

Content

Configure the information customers see when they browse your location results. The Content section of the Finder Builder controls two things: the card layout (how each result card is structured visually) and the fields that appear on those cards (which data points are shown and where).

🟡 [SCREENSHOT: Content section open in the Finder Builder, showing the Card Layout grid and the Field Management CTA button]

Card layout

The card layout sets the visual structure of every result card in the list. Choose the layout that best matches the amount of information you want to surface and the visual style of your site.

LayoutWhat it showsBest for
CompactLocation name + address onlyHigh-density lists, stores-only finders
StandardName, address, tags, and action buttonsMost use cases; recommended starting point
RichName, address, and a location imageImage-heavy finders, hospitality, retail
Map-pin onlyMap pin on a card background; no textDecorative or map-first experiences

💡 Tip: The card layout controls the overall structure, but the exact fields shown inside each layout are controlled by Field Management. Switching card layouts does not automatically turn fields on or off.

🔴 [NEEDS CLARIFICATION: Is card layout selection persisted to finder settings, or is it currently a TODO (the source code has a comment // TODO: persist user selection)? If not yet persisted, warn users.]

Field Management

Field Management is where you choose which data points appear on result cards and exactly where each one sits. Open it by clicking Open Field Management in the Content section.

How it works

Each field you add is placed into one of six drop zones on the card:

ZonePositionTypical content
Header · LeftTop row, left columnDistance, badges, eyebrow category
Header · RightTop row, right columnStatus pill, secondary label
Body · LeftMain body, left columnAddress, tags, text fields
Body · RightMain body, right columnDirections button, hours, CTAs
Footer · LeftBottom row, left columnPhone number, hours
Footer · RightBottom row, right columnWebsite link, secondary info

Drag fields between zones to reorder them. Toggle the switch next to any field to show or hide it without removing it from your configuration.

Built-in fields

These fields come pre-configured and pull from the core location record:

FieldData sourceNotes
Full addressStreet + city, state, ZIPCombined shorthand — do not use alongside Street only or City, State, ZIP
Street onlyStreet address line 1
City, State, ZIPCity / state / postal
CountryCountry field
DistanceCalculated from searchHidden automatically when Hide distance until searched is on
TagsLocation tagsRespects tag display settings (max count, primary tag)
Directions buttonLinks to maps providerOpens turn-by-turn directions
HoursBusiness hoursCan show as status pill, full week list, or both
Phone numberPhone fieldRenders as a tel: link
Website linkWebsite URLConfigurable as plain URL, text link, or button
Location imageImage URLAspect ratio 16:9, lazy-loaded

⚠️ Warning: Adding both Full address and Street only (or City, State, ZIP) to the same zone will cause address lines to appear twice. Use Full address alone, or use the individual fields together but not both.

Custom fields

Custom fields defined in your workspace are available in the Field Management library. Drag any custom field onto the card and it will display the value stored for each location. Custom fields that do not have a value for a specific location are hidden automatically for that card.

You can also create a new custom field directly from within Field Management without leaving the builder.

💡 Tip: The order you place fields within a zone controls the display order on the card. Fields in the same zone stack vertically in the order they appear in the drop zone.

Hide distance until searched

A toggle at the top of Field Management controls whether the distance figure is visible before a visitor performs a search. When this is on, distance values stay hidden until the viewer enters a search — useful when most of your locations share a similar geographic area and distance rankings would be misleading before a search is made.

🟡 [SCREENSHOT: Field Management modal open, showing zones with fields dragged in and the distance toggle]

What lives in Language and Copy instead

The Content section controls which fields appear on location cards. It does not control text strings such as the empty-state message shown when no results are found, search bar labels, or the directions button label. Those strings are managed in the Language and Copy section, where you can override each string per finder or switch the display language.

Key strings you might expect to find here that live in Language and Copy:

  • Empty state title (list.emptyTitle) — default: “No locations found”
  • Empty state body (list.emptyBody) — default: “Try adjusting your search or filters.”
  • Directions button (list.directions) — default: “Get directions”
  • Show more button (list.showMore) — default: “Show more locations”
  • Results eyebrow (list.nearbyResults) — default: “Nearby results”