---
title: "Toolkit: Deals Page & Sale Badges"
description: "> Deals puts a sale badge on the result card of every home that is part of a live Conversion Kit sale, and gives you a Deals page that lists exactly those homes. When the sale ends, the badges and…"
url: "https://homerunner.io/docs/toolkit-deals/"
updated: "2026-11-10"
category: "Branding & Conversion"
---

# Toolkit: Deals Page & Sale Badges

> Deals puts a sale badge on the result card of every home that is part of a live Conversion Kit sale, and gives you a Deals page that lists exactly those homes. When the sale ends, the badges and the page follow on their own.

---

## What it does

You set the sale up once, as a Conversion Kit Promo Bar campaign: the homes, the dates, the message and the coupon. The Deals module reads that campaign and shows it in two places while it is live:

- **A sale badge on result cards.** Every home in the sale wears an "On sale" badge on its card in your listings, searches and property grids. When the campaign states a discount and its coupon checks out against your live rates, the badge can show the number instead, for example "15% off".
- **A Deals page.** The `[homerunner-deals]` shortcode shows your regular search, limited to the homes on sale. Guests can still add dates and guests, see prices and sort the results.

Nothing is tagged and nothing is scheduled inside the Toolkit. The campaign decides which homes are on sale and for how long. When no sale is live, the badges disappear and the Deals page shows a short message instead of an empty search.

## Requirements

- The Conversion Kit, with its Promo Bar tool turned on and a scheduled campaign that applies to specific homes.
- If the Conversion Kit or its Promo Bar is off, the module stays quiet: no badges, and the Deals page shows its "nothing on sale" message.

## Turning it on

### 1. Enable the module

In your WordPress admin, open **HomeRunner**, then **Toolkit**, and enable **Deals Page & Sale Badges**.

### 2. Check the status

Open the module's settings. The top of the panel tells you whether the Conversion Kit is active and whether a sale is live right now.

### 3. Adjust the text

Change the badge and page text if you want to (see Settings below), then click **Save Deals Settings**.

### 4. Add the Deals page

Create a page for your deals, for example "Deals" or "Special Offers", and add the shortcode `[homerunner-deals]`.

## Settings

| Setting | What it does |
| --- | --- |
| **Badge text** | What the badge says on a home whose sale does not state a discount. Default: "On sale". |
| **Badge text with a discount** | Used when the campaign states a discount and its coupon checks out. `{pct}` becomes the number, so "{pct}% off" reads "15% off". Leave it blank to use the plain badge text for those homes too. |
| **Badge color** | The badge background, as a hex color such as #c62828. Leave it blank to match your other card badges. The text color adjusts itself for contrast. |
| **Deals page, nothing on sale** | What the Deals page says while no sale is live. Default: "No homes are on sale right now. Check back soon." |

## The Deals page shortcode

`[homerunner-deals]` works like the regular explorer shortcode, limited to homes on sale. The map is off by default.

- Add `map="1"` to show the map.
- Add `view="grid"` for a simple card grid without dates or prices. It loads fastest and suits a homepage section.
- Add `empty_text="..."` to replace the "nothing on sale" message on that one page.
- Add `class="..."` to give the page's wrapper your own CSS class.
- Any other explorer attribute you already use, such as `template` or `per_page`, works the same way here.

## Tips

- **Badges not showing on your regular listings?** If the explorer's "hide groups" setting is on, it hides every card badge on your listings pages. The Deals page shows badges either way. Turn the setting off under **HomeRunner > Settings > Explorer grid**. The Deals settings panel warns you when this applies.
- **Changes follow the campaign.** To end a sale early, pause or end the Promo Bar campaign. The badges and the Deals page follow the campaign's window.
- **A discount badge needs a real coupon.** The Promo Bar checks the coupon against your live rates when you save the campaign. If it does not produce a real saving, the badge falls back to the plain badge text.