Bedroom Showcase builds a photo card for every bedroom straight from your synced property data, so the section always matches what is actually at the property, without anyone touching the page.
What it does #
Bedroom cards, one per room, with a photo, the bed types, and a short description, are one of the sections sites end up hand-building in a page builder: a static grid, laid out once when the property is first set up. The problem is that nothing about that grid knows about your property management system. Add a bedroom, change a bed from a queen to two singles, or swap in a new photo, and someone has to go find that grid item and edit it by hand, on every property, every time.
Bedroom Showcase removes that step. It builds the cards from two things you already maintain: the room data that syncs from your property management system (which rooms exist and what beds are in them), and the photo and description you fill into each bedroom’s custom fields. Whichever of those two changes, the cards update the next time the page loads. Nobody edits a template.
The module also handles a case that trips up hand-built grids: properties where the bedrooms are not numbered cleanly, for example a Bedroom 1 and a Bedroom 3 with no Bedroom 2. Bedroom Showcase reads the numbers in your room names when every room gives it a distinct one, and otherwise matches rooms to their photo and description fields in sync order instead, so a gap in the numbering never shifts a photo onto the wrong card. If a property is not synced with room data at all (for example, a system that does not sync it), the showcase falls back to reading directly from the numbered bedroom photo and description fields you have filled in, so the section still renders.
What guests and operators see:
- One card per real bedroom: a photo, the bed types and counts (for example, “Queen Bed: 1, Single Bed: 2”), and a short description.
- Clicking a photo opens it full-size in a lightbox guests can page through with next and previous controls or the arrow keys.
- A bedroom with no photo, no description, and no bed data yet simply does not get a card. Bedroom Showcase never shows an empty one.
- Descriptions support basic formatting, so a bullet list of room features works the same as plain text.
- If those photo and description fields are managed through the toolkit’s External Custom Fields (Google Sheets) sync instead of directly in your PMS, Bedroom Showcase reads from there automatically, no extra setup required.
How to turn it on #
1. In the HomeRunner Toolkit Hub, switch on Bedroom Showcase. #
2. Place the shortcode #
Add [hrtk_bedrooms] to the property page template, wherever the bedroom section belongs, whether that is in your page builder, a template, or post content. It reads live from the property it is placed on, so the same shortcode works unchanged across every property page.
If you want more control over the layout, a developer can add options to the shortcode: how many columns the grid uses (three by default), the photo’s aspect ratio (4:3 by default), whether the bed list, description, or photo shows at all, and a cap on how many cards appear.
3. Optional: turn on the automatic Rooms and Beds replacement #
If you would rather not touch a template at all, open the Bedroom Showcase settings in the Hub and switch on Replace the Rooms and Beds section. On single property pages, this finds the existing “Rooms and Beds” (or “Rooms & Beds”) heading and swaps the content under it for the showcase automatically. If a template already places [hrtk_bedrooms] itself, or a property has no rooms to show, the page is left exactly as it is.
4. Optional: match your PMS’s field names #
If the custom fields holding each bedroom’s photo and description are not named the standard way, enter your own pattern in the Bedroom Showcase settings so the module knows where to look.
Settings #
| Setting | What it controls |
|---|---|
| Replace the Rooms and Beds section | Off by default. When on, the default Rooms and Beds section content on single property pages is swapped for the Bedroom Showcase cards automatically, no template editing needed. Leaves the page untouched if a template already places [hrtk_bedrooms], or if a property has no rooms to show. |
| Bedroom photo field | Default bedroom{n}image. The name of the PMS custom field holding each bedroom’s photo, with {n} standing in for the bedroom number. Matching ignores case, spaces, and dashes, so bedroom{n}image also finds a field named “Bedroom {n} Image.” Leave blank to use the default. |
| Bedroom details field | Default bedroom{n}details. Same idea, for the field holding each bedroom’s description. |
Tips #
- Pair it with Bathroom Display if you also want full and half baths broken out clearly instead of collapsing into a single count.
- If the page also uses Property Section Nav for its sticky section menu, Rooms is one of the stops it links to, so guests can jump straight down to your bedroom cards.
- If a property shows nothing at all, check that at least one bedroom has a photo or a description filled in. A property with no synced room data and no bedroom fields populated renders an empty section on purpose, rather than a row of blank cards.
- A field name pattern must include
{n}for the bedroom number (for example,bedroom{n}image). A pattern that leaves it out, is left blank, or is unreasonably long is ignored, and Bedroom Showcase falls back to the default field names. - If the automatic Rooms and Beds replacement does not seem to run on a page, confirm that page actually has a “Rooms and Beds” heading. The swap looks for that heading specifically and stands down quietly if the template does not have one.