Replaces the plain Locations dropdown in your Explorer search bar with a tabbed “Find Your Destination” popup, so guests can browse by island, region, city, or resort instead of scanning one long list.
What it does #
A flat list of every location gets unwieldy once you have more than a handful of destinations, and guests often think in groups (“the islands,” “which resort”) rather than a single alphabetical list. Destination Filter takes over the Locations control in your Explorer search bar and replaces it with a tabbed popup: guests pick a tab (for example Island, City, or Resort), then browse or search within that group.
The destination tree is built from the property tags and location terms you already use in your PMS, so there is nothing to map by hand. Tag your properties consistently and the groupings appear automatically.
- Guests open a tabbed popup instead of one long dropdown
- Islands can expand to show their sub-regions nested underneath
- City and resort tabs can be searched by typing a label
- A footer shows “N filters applied” with Apply and Clear All buttons
- Selecting a destination filters Explorer results exactly the way the old Locations dropdown did
How to turn it on #
1. Switch it on in the Toolkit Hub #
In your WordPress admin, go to the HomeRunner Toolkit hub and switch on Destination Filter.
2. Set Explorer’s location source to Zone #
Destination Filter needs your Explorer search bar’s “Where” source set to Zone. Open Destination Filter in the Toolkit admin and check the source status shown there; it links you to the right setting if it is not already set to Zone.
3. Tag your properties #
Destination Filter reads three sources, all standard PMS tagging:
- Island / side / resort tags: property tags starting with a configurable prefix, by default
(i)for island (e.g. “(i) Kauai”),(s)for island side (e.g. “(s) East Kauai”), and(r)for resort (e.g. “(r) Poipu Kai”). Which island a side or resort belongs to is worked out automatically from which properties share those tags, so there is no manual island-to-region mapping to maintain. - Cities: your existing location terms, no special tagging needed.
A property with no matching tags simply will not appear under that tab. An admin-only “Data hygiene” table on the Destination Filter settings page flags common tagging problems (an empty label after the prefix, a side tagged under more than one island) so you can catch them before guests do.
4. Configure the tabs #
The Destination Filter settings page has a card-based tabs editor, up to 6 tabs. For each tab you set:
- Label and source (island/side/resort tag, city, or general location)
- Whether it groups by island (nests sub-regions under their island)
- Whether it is searchable (adds a label search box)
- Whether it is collapsible and starts open (accordion-style panels)
Reorder tabs by dragging their cards. Use Rebuild now after retagging properties to refresh the cached destination tree immediately rather than waiting for it to expire.
Settings #
| Setting | What it controls |
|---|---|
| Activation scope | “Marker class only” (default): only Explorer instances wrapped in a specific class are affected, useful for rolling this out to one page first. “All explorer instances site-wide” applies it everywhere. |
| Popup title | The heading shown at the top of the popup. Default “Find Your Destination.” |
| Tag prefixes | The island/side/resort tag prefixes Destination Filter looks for. Defaults to (i), (s), (r). |
| Show counts | Shows the number of properties next to each destination. |
| Live counts | Recomputes those counts on every request instead of using the cached tree. Off keeps the popup faster; on keeps counts always current. |
| Cache minutes | How long the destination tree is cached before rebuilding. Default 30 minutes. Use Rebuild now for an immediate refresh. |
| Tabs | Up to 6 tabs, each with its own label, source, grouping, search, and accordion behavior (see Configure the tabs above). |
Tips #
- If a tab looks empty to guests, check that the underlying properties are tagged with the matching prefix, then use Rebuild now rather than waiting for the cache to expire.
- Keep prefixes consistent across your PMS. A tag with the right prefix but an inconsistent label (extra spaces, different capitalization) is the most common reason a property lands in the wrong group.
- Pair Destination Filter with the Destination Index if you also want a browsable, SEO-friendly destination directory outside the search bar.