Behavior

The Behavior section of the Finder Builder controls how your finder acts at load time and during visitor interaction. These settings have no effect on visual styling — they determine what visitors can do and how results respond when they search, filter, or sort.

Open the Finder Builder, then select Behavior from the left-hand section menu. Settings are grouped into four subsections: Filters, Search, Results, and Map branding.

🟡 [SCREENSHOT: behavior section of builder with all four subsection groups visible]

Filters

These controls decide whether visitors can narrow results by tag, country, or distance — and how that filtering UI is presented.

Filter style

Choose how the filter UI surfaces to visitors:

Option	What it does
Panel	A slide-out or sidebar panel holds all filters. A button opens and closes it.
Inline	Filter controls appear directly in the results area without a separate panel.
None	No filter UI is shown.

💡 Tip: “Panel” is the most flexible starting point. It keeps the search area clean while still giving power users access to advanced filters.

Filter button placement (Panel mode only)

When Filter style is set to Panel, choose where the button that opens the panel lives:

Option	What it does
In search bar	The filter button sits inside the search input row.
In filter row	The button appears in a dedicated row below the search bar.

Filter panel style

Choose the visual layout of the filter panel itself:

Option	What it does
Accordion	Each filter group collapses and expands individually.
Two-pane sidebar	Categories appear on the left; options for the selected category appear on the right.

🔴 [NEEDS CLARIFICATION: Is the two-pane sidebar available on all plan tiers, or gated?]

Content filters

These toggles control which filter chips appear inside the filter panel.

Tag filter

Shows a chip filter for location tags in the refinements panel. Visitors can select one or more tags to narrow results.

Turn this on if your locations are tagged and you want visitors to filter by them. Tags are created and managed on the Tags and Custom Fields page.

Country filter

Shows a chip filter for countries in the refinements panel. Useful if your finder includes locations across multiple countries.

Quick filters row

Displays clickable tag and country chips directly above the results list — outside the filter panel — so visitors can apply common filters without opening the panel at all.

💡 Tip: Quick filters are a good choice when you have a small number of high-value tags (for example, product lines or service types) that most visitors will want to use.

Sort

Enable sorting

When on, visitors can reorder results by distance, location name, or city. When off, results appear in whatever order the finder returns them (typically distance-based after a search).

Sort UI (requires Enable sorting)

Choose how the sort control looks:

Option	What it does
Dropdown	A select menu shows the current sort order and lets visitors choose another.
Buttons	Pill-style buttons for each sort option appear side by side.
None	Sorting is enabled internally but no UI control is shown.

🔴 [NEEDS CLARIFICATION: When Sort UI is set to “None” with sorting enabled, what order does the finder default to? Is there a way to set the default sort value?]

When Filter style is Panel and Sort UI is Dropdown, choose where the sort control lives:

Option	What it does
In filter panel	The sort dropdown appears inside the filter panel alongside other filters.
Above results	The sort dropdown appears inline above the results list.

Distance and radius

Distance filter

Limits results to locations within the active search radius. When off, all matching locations are returned regardless of how far away they are.

⚠️ Warning: Turning this off means the Default search radius (in the Search section) has no effect on which results are returned — all matching locations are returned regardless of distance.

Show radius slider in search bar

Adds a radius slider directly in the search bar so visitors can widen or narrow the search area without opening the filter panel.

Radius control in filter panel

Adds a separate radius slider inside the filter panel. This gives visitors a second place to adjust the search radius — useful when the filter panel is your primary refinement surface and you want all controls in one place.

💡 Tip: You do not need both sliders active at the same time. “Show radius slider in search bar” is convenient for quick adjustments; “Radius control in filter panel” fits a more comprehensive filter workflow.

Search

These settings control how the search bar works and where it appears.

Search mode

Option	What it does
Default	Standard keyword search across location names, addresses, and other indexed fields.
Locations only	Search is restricted to location names and addresses — no tag or custom field matching.
Natural language	🔴 [NEEDS CLARIFICATION: What does natural language mode do? Does this require an AI feature to be enabled?]

Search position

Choose where the search bar appears relative to the map and listing panel:

Option	What it does
Above map and listings	The search bar spans the full width above both the map and the list.
Above listings	The search bar sits above the listing panel only, inside the list column.
Above map	The search bar appears above the map, with the listing panel below it.
Overlay map	The search bar floats over the map surface.

🔴 [NEEDS CLARIFICATION: Are all four positions available for every layout (split, list-only, cards)? The source shows search position is read from design.app.searchPosition; some positions may only apply to split layouts.]

Default search radius

A slider that sets the initial search radius when the finder loads — before the visitor adjusts it. Range is 1–500 in the selected unit.

Unit

Choose whether distances display in miles (mi) or kilometers (km). This affects the search radius slider, the radius filter, and the distance shown on each location card.

Results

Show all listings by default

When on, all locations appear on the map before the visitor runs a search. Visitors see the full set of pins immediately on load.

When off, the map starts empty. Locations only appear after the visitor enters a search term or applies a filter.

💡 Tip: Turn this on for finders with a small, curated set of locations (for example, a brand’s own retail stores). Turn it off for large datasets where showing all locations at once would overwhelm the map or slow the initial load.

Map branding

Add a custom text watermark to the map corner — for example, your brand name or a short tagline. The watermark appears as a small frosted-glass badge in the lower-left corner of the map.

Show watermark

Toggle the watermark on or off. When on, two additional controls appear.

Watermark label

The text displayed in the watermark badge. Accepts plain text only (no HTML or Markdown).

Example: BzzSoda · find your buzz

Watermark opacity

A slider from 0% (fully transparent) to 100% (fully opaque). The default is 40%.

⚠️ Warning: The watermark is purely decorative and is hidden from assistive technology (aria-hidden). Do not use it to convey information that visitors need to interact with the finder.

Mobile behavior

On screens 640 px wide or narrower, split-layout and overlay-layout finders automatically switch to a tab-based interface — one tab for the map, one for the list. Visitors tap a marker on the map to see a brief “peek” card with the location name, address, hours status, and quick-action buttons (Get directions, Details). Tapping Details opens a full-screen detail view.

This behavior is automatic and is not configurable from the builder. Layout choice (split, list-only, cards) is set in the Layout section, not here. See the Embedding guide for tips on controlling the finder’s container size on mobile.

🟡 [SCREENSHOT: mobile tab bar on a split-layout finder at 390px width]

Finder Builder — overview of all builder sections
Refinements — creating the tag and country values that appear in filter chips
Embedding — setting the finder’s container size and mobile context