Advanced refinements

Advanced refinements let you create named filter-and-sort rules that visitors can apply with a single click inside the widget. Each rule combines one or more field conditions with an optional sort, and you control whether matching locations are shown or hidden. This feature is available on the Bronze plan and above.

💡 Tip: Advanced refinements are visitor-driven — they appear as buttons in the widget and visitors choose which ones to apply. They are a companion to the standard Refinements panel, not a replacement.

How it works

When a visitor opens the refinements panel, any active advanced rules appear as a list of labeled buttons. The visitor selects the rules they want; the widget immediately filters and/or re-sorts the results. Selecting a rule does not change the map view until results update.

Conflict resolution: If a visitor selects both a Show rule and a Hide rule that both match the same location, the Hide rule wins. This lets you build opt-out rules (e.g. “Hide closed”) that always take priority over opt-in rules.

Sort priority: When a visitor activates multiple rules that each include a sort, only the sort from the first selected rule is applied.

Creating a rule

In the Finder Builder, go to Behavior → Advanced rules (marked with a Pro badge). Click New rule to add a rule card.

Rule name

The name is what the visitor sees on the button. Keep it short and action-oriented: Open now, Pet-friendly, Drive-through only, Near me (10 mi).

Action: Show or Hide

Action	Effect when the visitor selects this rule
Show	Display only locations that match all/any of the conditions
Hide	Remove locations that match all/any of the conditions

Match: All or Any

All — every condition must be true for a location to be affected (logical AND)
Any — at least one condition must be true (logical OR)

Conditions

Each condition targets a location field, applies a comparator, and specifies one or more values.

Filter fields:

Field	Matches against
Tags	Any tag name assigned to the location
City	Location city
State	Location state or province
Country	Location country
Zip code	Location postal/ZIP code
Phone	Location phone number
Hours	`open` or `closed` based on current time
Ratings	Numeric rating value

Comparators:

Comparator	Behavior
contains	Field value includes the text string (free-text input)
is	Field value exactly matches one of the selected values (multi-select from your location data)
is not	Field value does not match any of the selected values

When you choose is or is not, the value picker is populated from your actual location data so you can pick from real values. When you choose contains, you type a substring.

You can add multiple conditions to a single rule using the Add condition button. All conditions in a rule share the same All / Any match logic.

Optional sort

Each rule can include one sort instruction applied when the visitor activates that rule. Click Add sort inside the rule card.

Sort fields: Distance, Name, Country, State/Province, City, ZIP, Hours

Sort directions:

Direction	Behavior
A-Z / near first	Ascending (alphabetical, nearest first)
Z-A / far first	Descending (reverse-alphabetical, furthest first)
Open first	Locations currently open appear before closed
Closing soon	Among open locations, those closing soonest appear first

⚠️ Warning: If a rule’s sort direction is Open first or Closing soon, the sort relies on live hours data. Locations without hours data are treated as closed.

Active / Inactive toggle

Use the toggle on each rule card to enable or disable the rule. Inactive rules are saved in the builder but do not appear in the widget. This lets you draft rules without publishing them.

Ordering rules

Drag or use the up/down arrow buttons on each rule card to set the display order. Visitors see rules in this order in the widget.

Example rules

Show only locations in a specific country:

Name: Canada only
Action: Show — Match: All
Condition: Country is Canada

Hide locations without a phone number:

Name: Has phone
Action: Hide — Match: All
Condition: Phone is (leave value blank)

🔴 [NEEDS CLARIFICATION: Does “contains” on Phone with an empty value match locations with no phone, or does blank value behave differently? Verify in filtering.js line ~83.]

Show franchises in a specific city and sort by name:

Name: Austin locations
Action: Show — Match: All
Condition: City is Austin
Sort: Name, A-Z / near first

Show open locations, sorted by closing soon:

Name: Open now
Action: Show — Match: All
Condition: Hours is open
Sort: Hours, Closing soon

Hide a tag group:

Name: Hide seasonal
Action: Hide — Match: Any
Condition: Tags contains seasonal

Saving and publishing

Rules are saved automatically as you build. When you publish your finder, only active (enabled) rules are written to the live widget. Inactive rules remain in the builder draft and are not visible to visitors.

🟡 [SCREENSHOT: Advanced rules section in Finder Builder — show a rule card expanded with Show/Hide toggle, All/Any match, two conditions, and an optional sort row, with the rule name “Open now” filled in.]

Refinements — standard filter and sort options (available on all plans)
Behavior — the full Behavior section of the Finder Builder
Tags and custom fields — source data for tag-based conditions