Property Actions gives your property page one ready-made action row (Share, Save, Plan with AI, and an optional “All Properties” link) that you place once, so guests can pass a home along, keep it, or plan with an AI assistant without you building or maintaining those buttons yourself.
What it does #
Most property pages need the same small row of actions near the title: a way back to the full property list, a heart to save the home, a Share button, and (if you use the AI Booking Channel) a “Plan with AI” entry point. Until now that row was assembled by hand in each site’s page template, and Share usually leaned on a separate pop-up plugin. Every template edit meant rebuilding it, and Share behaved differently from site to site.
Property Actions replaces that hand-built row with a single element you drop into the template. It draws the buttons, wires up Share, and borrows Save and Plan with AI from the modules that own them.
What a guest sees on the property page:
- All Properties (optional): a link back to the properties page set in HomeRunner, with a back arrow.
- Save: the Conversion Kit wishlist heart. Tapping it saves the home to the guest’s wishlist.
- Share: on a phone, the device’s own share sheet opens (Messages, WhatsApp, Mail, AirDrop, whatever the phone offers). On a desktop browser, or wherever the device has no share sheet, a simple dialog opens with a copyable link and a short list of channels.
- Plan with AI: the AI Booking Channel’s “Plan with AI” dialog, opened in place.
Say a guest on her phone has picked October 10 to 14 for two adults and one child, then taps Share and sends the home to a friend over WhatsApp. The friend opens the link and lands on the same property with the same dates and guest count already filled in, ready to check the price.
How Share behaves #
Share tries the phone’s or tablet’s own share sheet first. That works on a site served over HTTPS in a browser that offers one (most phones do). If the guest dismisses the sheet, nothing else happens. If the browser has no share sheet, or the sheet fails, the share dialog opens instead:
- The heading reads Share this home on a property page and Share this page anywhere else. Underneath sit the home’s cover photo (its featured image, or the first listing photo when no featured image is set) and its name, so the guest can see which home is about to go out.
- A read-only link field always shows the address, with a Copy link button beside it. Copying confirms with “Link copied”; if the browser blocks copying, the link stays selected and a short note tells the guest to press Ctrl+C or Cmd+C.
- Below the link sit the channels you have switched on: Email, Text message, WhatsApp, Facebook and X. Email and Text message hand off to the guest’s mail or messaging app. WhatsApp, Facebook and X open in a new tab. The Text message row appears only on iPhone, iPad and Android, where a text link reliably opens the composer.
- On a phone the same dialog slides up from the bottom of the screen as a sheet. Escape, the close button or a tap outside the panel closes it and returns focus to the Share button.
No third-party script loads for any of this.
What the shared link carries #
The shared link is the page’s own address, cleaned up. Every other part of the address a visitor might have arrived with (ad and campaign tags, click IDs, anything typed by hand) is dropped. When Share the guest’s dates and guests is on and the guest has picked a stay, the link keeps exactly those values: check-in and check-out dates (only as a valid pair, check-out after check-in), the guest count, and the adults, children and pets counts from the Guest Picker. Each value is checked before it is added; anything malformed is left out.
Email, text and the share sheet also get the page title and, when the property has an excerpt, a one-line teaser from it (plain text, trimmed to about 160 characters).
Where Save and Plan with AI come from #
- Save is the heart from Conversion Kit: Wishlist. It appears only while that Wishlist tool is active, and only on property pages, since there has to be a property to save. In the Link and Button styles it shows the heart with a “Save” label; in the Icon only style it shows the heart alone.
- Plan with AI is the trigger from the AI Booking Channel. It appears only while that module is on with Show the guest entry point switched on, and once per page: if your template already has a standalone AI-Ready Trigger element, the row leaves its own Plan slot out. It never appears on the checkout or confirmation page.
A slot whose owner has nothing to show simply disappears, and a row with no slots left prints nothing at all, so you can place the element once and let it adapt as you turn modules on and off.
How to turn it on #
1. In the HomeRunner Toolkit Hub, switch on Property Actions #
Open the HomeRunner Toolkit Hub, find Property Actions and switch it on. Its settings panel opens beside it.
2. Set the site-wide defaults #
In the Property Actions panel, choose which actions the row shows when a placement does not say otherwise (Share, Save, Plan with AI), the default Style, whether the “All Properties” back link shows, whether the shared link carries the guest’s stay, and which share dialog channels to offer. Every placement can override the actions, the style and the back link; the channels and the stay setting apply everywhere. Press Save.
3. Place the row on your property page #
Pick whichever placement matches how your property page is built:
- YOOtheme builder: add the Property Actions element (in the Homerunner group). On its Content tab, tick Share, Save, Plan with AI and Show “All Properties” as needed. On its Settings tab, set Style (Module default, Link, Button or Icon only) and Alignment (None, Left, Center or Right). Margins, visibility and custom classes work the way they do for any builder element.
- Block editor: add the Property Actions block (in the Widgets category). Its sidebar has the same three action toggles, the “All Properties” back link toggle and the Style choice. The editor shows a labelled placeholder listing what is switched on; the real row renders on the live page.
- Shortcode:
[hr_property_actions actions="share,save,plan" style="link" back="1"]. Every attribute is optional and falls back to the Hub default when left out:
| Attribute | What it does |
|---|---|
actions | Comma-separated list of share, save and plan, shown in the order you write them. This is also the only place to reorder the row. Leave it out, or list nothing valid, to use the Hub’s action toggles. |
style | link, button or icon. Anything else uses the Hub’s Style. |
back | 1, true, yes or on shows the “All Properties” link; 0, false, no or off hides it. Left out, the Hub setting applies. |
class | Extra CSS classes for the row, for your own styling. |
To place Share on its own, anywhere on the site, use [hr_share]. It takes an optional label (the button text; “Share” by default), style (link, button or icon) and class. Any number of Share buttons can sit on one page; they all open the same dialog.
4. Replace any hand-built row #
If your property page template already carries a hand-assembled row (an “All Properties” link, a wishlist heart, a Share button driven by a pop-up plugin), take those pieces out and put one Property Actions element in their place. Keeping both gives guests two hearts and two Share buttons. A modal plugin your site used only for Share can be deactivated afterwards.
5. Turn on what Save and Plan depend on #
Save needs the Wishlist tool active in Conversion Kit. Plan with AI needs the AI Booking Channel on with Show the guest entry point switched on. Neither is required: with both off, the row still shows Share (and the back link, if enabled).
Settings #
| Setting | What it controls |
|---|---|
| Share | Includes the Share button in the row by default. On by default. |
| Save | Includes the Conversion Kit wishlist heart by default. Shows only while that Wishlist tool is active. On by default. |
| Plan with AI | Includes the AI Booking Channel trigger by default. Shows only while its guest entry point is on, and once per page. On by default. |
| Style | The default look of every item. Link takes the type of the row it sits in. Button draws an outlined pill. Icon only shows each icon alone, with the label kept for screen readers. Default: Link. |
| “All Properties” back link | Adds a link to the properties page set in HomeRunner at the start of the row. Off by default. |
| Share the guest’s dates and guests | When the guest has picked dates or a guest count, the shared link opens the property with the same stay. Everything else in the address (ad and campaign tags included) is always left out. On by default. |
| Copy link | Shows the Copy link button in the share dialog. The link field itself always shows. On by default. |
| Offers Email in the share dialog. On by default. | |
| Text message (phones only) | Offers Text message in the share dialog, on iPhone, iPad and Android only. On by default. |
| Offers WhatsApp in the share dialog. On by default. | |
| Offers Facebook in the share dialog. On by default. | |
| X | Offers X in the share dialog. On by default. |
The share dialog only shows where the device has no share sheet of its own; on most phones the guest sees the phone’s sheet instead, and the channel settings do not apply there.
Tips #
- Share button missing? The button only appears once the page’s scripts have run and it has somewhere to go (a share sheet or the dialog). Check that the site loads over HTTPS and that nothing on the page is blocking the Toolkit’s scripts.
- Plan with AI missing? Confirm the AI Booking Channel is on with Show the guest entry point switched on, and that the page does not already carry a standalone AI-Ready Trigger element (the row yields to it). Plan with AI never shows on the checkout or confirmation page.
- Save missing? Confirm the Conversion Kit Wishlist tool is active. The heart also only renders on property pages.
- Every completed share sends a
shareevent carrying the method (share sheet or dialog) and the channel, and each Save or Plan tap sends anhrtk_property_action_clickevent with the action name, through the same GA4 or data layer path as Conversion Tracking. Use them to see which channels guests actually share through. - Property Actions handles the row on the property page itself. For keeping Book Now, phone, contact and search visible in the collapsed mobile header, see Mobile Quick Actions.
- If your sitewide styles fight the Link style, switch to Button or Icon only on the placement rather than in the Hub: the placement’s own choice wins.
- See the Toolkit overview for the other property page modules.