Skip to main content
View Categories

Conversion Kit: Promo Bar

Promo Bar shows a scheduled announcement bar across your site, or only on the homes a sale applies to, with a button that sends guests straight into booking with your dates and discount already applied.

Premium tool. Promo Bar needs an active Conversion Kit Premium license. Conversion Kit Premium is an add-on to your HomeRunner subscription, priced at 25% of your HomeRunner Core fee. See add-on pricing


What it does #

When you run a sale or have something to announce, a seasonal discount, a last-minute opening, a minimum-stay drop, you need a way to put it in front of the right visitors and send them somewhere that honors the offer. A hard-coded banner is a problem on a cached site: the cache serves the same page to everyone, including guests who already booked or already closed the bar.

Promo Bar is a bar you schedule once and leave running. You write the message and a button, set when it runs, and it appears at the top or bottom of your pages during that window. By default it appears on every page of your site. You can also scope a campaign to specific homes, or to every home that carries a tag from your PMS, so a sale on three cottages does not show on a property page for a home that is not part of it. It is built for cached sites: the bar decides whether to show in each visitor’s browser, so a cached page still hides it from someone who already dismissed it or booked.

A visitor sees a slim bar with your headline, optional subtext, and a button. The button can work two ways:

  • An offer button opens a specific property with the dates and a coupon already applied, so the discounted rate the guest was promised is the rate they see.
  • An awareness button opens a pre-filtered search, for example a destination and date range, with no specific discount attached.

If a campaign advertises a percentage discount, it must point at one property with a real coupon. The coupon is checked against your live rates the moment you save, and a discount that does not resolve to a real saving is rejected, so the bar can never promise a deal it cannot deliver. A campaign with no offer is awareness-only and links to search.

How to turn it on #

1. Switch on the tool #

In Conversion Kit, open the Promo Bar tab and switch the tool on.

2. Set your global defaults #

Under Global Defaults, review the settings that sit behind the bar: the default edge, dismissal and suppression days, the reveal delay, the caps, and the privacy option. Of these, only Respect Global Privacy Control changes what visitors see today. The rest are saved for you, but each campaign currently starts with a 7-day dismissal, 180-day suppression after a booking, no reveal delay, and one appearance per browsing session, whatever these fields say. Choose the edge for each bar in the campaign editor.

3. Create a campaign #

Click New campaign. Give it a name, write the Headline, optional Subtext, and CTA label. Choose the Edge (top or bottom) and a Priority. When more than one campaign is live at the same time, the higher priority takes the bar.

4. Choose where it shows #

Under Where it shows, pick which pages carry the bar:

  • Leave every page type unchecked to show the bar on every page of your site.
  • Check Homepage, Property pages, or Search and results pages to limit the bar to those page types.
  • To make the campaign a sale for particular homes, type a home name in Homes and pick it from the list, or tick one or more Tags. Tags come from your PMS (for example Guesty tags) through the HomeRunner sync, so tagging a home in your PMS adds it to the sale on the next sync. A home counts as part of the sale if you picked it or if it carries one of the ticked tags.

A scoped bar shows on the property pages of the homes in the sale and not on the property pages of any other home. On other page types, the page types you checked alone decide. For example, check Homepage as well to show the sale bar on your homepage too. If you scope a campaign to homes and leave every page type unchecked, the bar also shows on every non-property page, so check Property pages to keep it to those homes. A note under the picker spells out what your current choices do.

Scoped campaigns also feed the Toolkit: while the sale is live, its homes appear on the Deals page and their result cards carry the sale label. See Toolkit: Deals Page & Sale Badges. A campaign that advertises a percentage discount is validated against one home, so on the Deals page and result cards it applies to that home only. For a percentage sale across several homes, create one campaign per home.

5. Schedule it #

Set the Timezone, then a Display start and Display end in that timezone. Set Status to Scheduled so it goes live during that window. Draft, paused, and archived campaigns never show on the site. Campaigns use fixed start and end dates for now; recurring weekly or monthly schedules come in a later release.

6. Add an offer (optional) #

Under Offer, set Rate enforcement to Coupon, then enter the Coupon code, the Advertised discount %, and the Bound property ID, which is the WordPress listing the coupon is validated against. Leave rate enforcement on None for an awareness-only bar that links to search. A third option, Pricing Rule, is also listed but is not yet wired to any validation, so it behaves the same as None for now.

7. Style it (optional) #

Leave styling off to use the theme default, a dark bar with white text. Or turn on Use custom colors to set the bar and button colors. Custom colors have to pass a contrast check so the text stays readable, and the editor shows a live preview.

Settings #

Global defaults #

SettingWhat it controls
Default edgeThe saved top or bottom preference. Set the edge for each bar in the campaign editor.
Default dismiss daysSaved for future use. Every campaign currently hides a closed bar for 7 days.
Converted suppression daysSaved for future use, capped at 180 days. Every campaign currently hides the bar for 180 days after a visitor books.
Default reveal delaySaved for future use. Every campaign currently shows the bar right away.
Per-session capSaved for future use. Every campaign currently appears once per browsing session.
Global exposure capSaved for future use. A cross-campaign limit per visitor is not enforced yet. Defaults to 6.
Respect Global Privacy ControlHonors the browser’s GPC privacy signal and keeps targeting off for those visitors. On by default.

Per campaign #

SettingWhat it controls
NameInternal name for the campaign.
Headline, Subtext, CTA labelThe bar’s message and button text.
StatusDraft, Scheduled, Paused, or Archived. Only Scheduled campaigns appear, and only during their window.
EdgeTop or bottom of the page for this campaign.
PriorityWhich campaign takes the bar when more than one is live at once. The higher number shows.
Where it shows: page typesHomepage, Property pages, and Search and results pages. With none checked, the bar can show on every page.
Where it shows: HomesHomes you pick by name. Up to 500 homes. With none picked and no tags ticked, the campaign is not scoped to homes.
Where it shows: TagsPMS tags. Every published home carrying a ticked tag joins the sale. The list shows how many homes each tag has.
Timezone, Display start, Display endWhen the campaign runs, in the timezone you set.
Rate enforcementNone for an awareness bar, or Coupon to advertise a validated discount. A Pricing Rule option is also listed but has no effect yet.
Coupon code, Advertised discount %, Bound property IDThe coupon, the discount it advertises, and the single property it is validated against. Required together when advertising a discount.
Custom colorsOptional bar and button colors. Must pass a readability contrast check.

Tips #

  • A bar that opens or closes on a schedule appears and disappears on time even on a cached site. Conversion Kit clears your page cache when each campaign’s window starts and ends, and whenever you save, pause, or delete a campaign, so you do not need to purge the cache by hand.
  • The campaign list shows live performance per campaign: views, click-through rate, dismissals, and assisted bookings, so you can see which promo is working.
  • A bar that advertises a percentage discount must bind a coupon to one property, and the coupon is verified against your live rates when you save. If a save is rejected, check that the coupon code is valid for that property and produces a real discount.
  • Running a sale on a group of homes? Tag them in your PMS once, tick that tag in the campaign, and new homes you tag later join the sale on the next sync.
  • If a scoped bar does not show on a home’s property page, check that the home is picked or carries a ticked tag, and that Property pages is checked or no page type is checked.
  • Promo Bar needs your theme to include the standard WordPress body-open location. If the bar does not appear, that is the first thing to check.
  • Promo Bar stores a little information in each visitor’s browser to remember dismissals and frequency. The Privacy and storage section lists exactly what it stores, with a button to clear it for the current browser. For more on how the Conversion Kit handles guest data, see Conversion Kit: Under the Hood, and the HomeRunner Conversion Kit Overview for the full feature list.