FW Real Estate – Documentation

The FWRE Featured add-on marks a property as featured: a visible badge on the listing card, an optional pin to the top of every results page, an expiry date that removes the promotion automatically, and a record of how many times the placement was seen and clicked.

Impressions and clicks are what separate this from a cosmetic badge. If you sell featured placement, or you are deciding which properties deserve it, those figures are the difference between promoting on evidence and promoting on instinct — and they are exactly what a client asks for after paying for a slot.

Use Cases

• Paid placement. Sell a featured slot with a run-out date; the property drops back to normal on its own when the period ends.
• Editor's picks. New construction, best value, the listing you want walk-ins asking about.
• Home-page highlights. The Latest module, Layout Anywhere, and the WordPress Listing block can all be filtered to featured properties only, so a highlights section maintains itself as you change which properties are featured.
• Proving the placement worked. The impressions and clicks columns show what a featured property actually received — the report you hand a client after a paid run.

Settings

Open Configuration → Add-ons → Featured to find the single setting for this add-on.

• Featured listings on top — when enabled, featured properties appear before all other results in every listing, regardless of the ordering the visitor has chosen.

Important: this setting overrides the visitor's own sort order. A visitor who sorts by price ascending still sees featured properties first, meaning the first row is not the cheapest. Be aware of this before enabling it in a price-sensitive market.

Featuring a Property

There are two ways to feature a property:

• From the properties list, using the star column — one click, no need to open the record.
• On the property form, where you can also set Featured until.

Featured until is what makes paid placement self-managing. When the date passes, the site's scheduled job un-features the property automatically. Leave it empty to keep the property featured until you switch it off by hand. There is no start date — a property becomes featured the moment you feature it.

Impressions and Clicks

The properties list shows two extra columns for featured properties: how many times the property was shown in a listing, and how many times it was clicked through to. A property with many impressions and few clicks usually has a photo or a price problem, not a placement problem — the slot delivered exposure; something about the card discouraged action.

On the Front End

• A Featured badge on the listing card, styled by the active design.
• First position in every listing when Featured listings on top is enabled.
• A Featured only filter available in the Latest module, Layout Anywhere, and the WordPress Listing block.

Notes

• There is no limit on how many properties can be featured, and no warning when you have featured too many. Featuring everything is the same as featuring nothing — the badge only works while it is scarce.
• Featured status is a CSV column, so it can be set in bulk from a spreadsheet import.
• Disabling the add-on removes the badge, the ordering override, and the filter. The flags remain in the database and are restored when the add-on is re-enabled.

To install this addon, open the Add-ons panel inside FW Real Estate. See Getting Started → Add-ons for details on free addons, paid addons, and site verification.