Collapse identical listings into a single search result, so a property with many interchangeable units shows one clean card while each booking still lands on a real, specific unit.
What it does #
If you manage a resort with twenty near-identical cabins, or hotel-style inventory where many units are the same, your search results fill up with twenty almost-identical cards. That buries your variety and makes the page harder to shop.
Clustering groups those interchangeable units and shows a single representative card for the group. The card stays visually stable, using one unit’s title and photo, so the results page reads cleanly. When a guest clicks through, Clustering routes them to a randomly chosen available unit from the group, so the reservation still binds to a specific physical unit and your calendars stay correct.
You decide what counts as “the same” with one or more grouping rules:
- Group by a property tag, or by a custom field value.
- Choose the tag or field that identifies a group, for example a “unit type” field.
- Optionally narrow a rule to a single value, so it only clusters properties whose value matches exactly.
How to turn it on #
1. Enable the module #
In the HomeRunner Toolkit Hub, switch on Clustering.
2. Add a grouping rule #
Open the Clustering settings and add a rule. Pick the source (a property tag or a custom field), enter the tag or field that defines a group, and leave the value blank to group by any shared value, or enter a specific value to scope the rule to just those properties. Add more rules if different parts of your inventory group on different fields.
Settings #
| Setting | What it controls |
|---|---|
| Enabled | Turns Clustering on or off. It is off by default, so nothing changes until you enable it and add a rule. |
| Rule: Source | Where the grouping value comes from: a property tag or a custom field. |
| Rule: Key | The specific tag or custom field that identifies a group, for example a “unit type” field. |
| Rule: Value (optional) | Leave blank to cluster by any shared value under that tag or field. Enter a value to cluster only the properties that match it exactly. |
Tips #
- If listings are not collapsing, confirm the rule’s key matches a real tag or custom field on your properties, and that the units you expect to group actually share the same value.
- Because each click resolves to a random available unit in the group, Clustering is best for genuinely interchangeable inventory. Use a specific value on a rule when you want to cluster only part of your catalog.
- Clustering shapes what guests see in search results, so it pairs naturally with Flexible Search and the Property Map Display.
- The HomeRunner Toolkit is included with HomeRunner at no extra cost, so this module is available on every plan.