How to Give Buyers a Country-to-City Property Search (Free Widget)
What Most Free Plugins Give You Instead
If you've been comparing free real estate plugins and looking for a country-to-city property search that narrows results at each step, you've probably found the same thing in most free plugins: a single text input labeled "Location" and a search button. The buyer types something, the plugin searches it, and results either arrive or don't, depending on whether the text matches whatever string is in your database.
That's fine when your listings are all in one city. It breaks down fast when you have properties in multiple countries or across regions with similar city names. A buyer who wants listings in Valencia, Spain, not Valencia, California, has no way to specify that in a single text field. They get whatever the search returns, or they leave.
The flat single-field input is easy to build and genuinely difficult to use at scale. Most free plugins ship it because location data is complicated, and a cascading dropdown requires knowing which countries, regions, and cities are actually in your database before the page renders.
FW Real Estate takes a different approach. The location search builds its dropdowns from your live listing data, so only valid options appear at each level, and each selection narrows what comes next.
How the Cascade Works: Country, Then Region, Then City
A cascading property search is a location filter that narrows its options at each level based on what the buyer has already selected, so they see only the countries, regions, and cities where listings actually exist.
The search starts with a country dropdown. A buyer picks a country, and the region dropdown immediately updates to show only the regions where you have active listings in that country. When they pick a region, the city dropdown updates to show only cities in that region.
Each selection filters the next dropdown to valid options only. If your database has listings in Germany and Portugal, a buyer who picks Germany sees German regions and then German cities. They never see Lisbon in their city list, because there's nothing to find there.
This is different from a search that loads every option upfront and hides invalid ones on the client side. The cascade reads from your database at each step, which means it reflects your actual inventory. Add a listing in a city that wasn't in your database before, and that city shows up in the dropdown on the next page load.
The cascade reflects what's actually in your database at that moment. There's no manual step to update the location lists when new listings come in.
The search works alongside other filters too. A buyer can narrow by country and city, then layer on price, property type, or number of bedrooms, depending on what else you've placed on the search form.
Placing It in a Sidebar: the Widget Route
The widget path uses WordPress's standard Widgets screen. Go to Appearance > Widgets, find the FW Real Estate location search widget, and drag it into any widget area your theme registers.
The settings panel gives you a title field (the label shown above the dropdowns) and visibility toggles for each dropdown level. If all your listings are in one country, you can hide the country dropdown to keep the form shorter. The region and city dropdowns still work normally.
No shortcode, no custom template, no PHP required. Drag it in, configure the title and visibility, save. The dropdowns appear on the front end and submit searches to your listings archive.
One thing to check before you start: if your theme uses the block-based widget editor rather than the classic one, you'll find the widget as a block inside that editor instead of in a separate widget list. It works the same way either route.
Placing It on a Page: the Block Route
If you're working in the block editor or with a block theme, the search inserts directly wherever you need it. Open any page or post, add a new block, search for "FW Real Estate," and the location search block appears in the results.
Drop it into a full-width hero, a column layout, or a Group block alongside a background image. The block respects its container's width constraints, so it fits a narrow column just as well as a wide section.
The block's settings panel (in the right-hand sidebar of the editor) mirrors what the widget offers: a title, visibility toggles for each dropdown level, and the URL of the page it submits searches to. If your listings archive is at /properties, point the block there and searches route correctly.
This path is the one you'll use if your theme has no traditional widget areas, which is increasingly common on full-site editing themes. The widget route assumes a sidebar exists; the block route works anywhere the editor works.
If every buyer on your listings page sees every city in your database regardless of which country they picked first, the cascade is missing. FW Real Estate's location search answers that: pick a country, and only that country's regions appear; pick a region, and only that region's cities follow. Three things the free download gives you: the cascading filter itself, reading live from your database so only locations with active listings show up; the search available as a sidebar widget and as a native block; and no add-on required for any of the filtering described in this post. Install it and the country-to-region-to-city search is yours to keep, and to build around with whoever you choose. Get the cascading location search free →
What This Covers Free and Where Add-ons Begin
The location search, in both the widget and block forms, ships with the free plugin. Filtering listings by country, region, and city is part of the free download. No add-on is needed for any of the search behaviour described in this post.
Where add-ons come in is when your listings come from a live external source. If you want the plugin to pull properties from an MLS or an IDX data source, keep them updated automatically, and sync prices and availability without manual imports, that requires the MLS/IDX add-on. Once that data is in your database, the location cascade works exactly the same way.
To draw the line clearly:
- Adding listings by hand: free.
- Importing listings from a CSV file: free.
- Location search across all your listings: free.
- Live MLS or IDX feed with automatic sync: MLS/IDX add-on.
Some competing free plugins tie their location search to their own paid IDX feed, which means the search only works if you're paying for their data layer. That isn't the case here. The search runs against your database regardless of how the listings got in.
If you're already paying a monthly fee for a rented IDX widget, that fee typically covers both the data feed and the search interface together. Moving to FW Real Estate means the MLS/IDX add-on replaces the feed cost, and the search widget becomes part of the plugin rather than a locked rental.
Install and Try It on Your Test Site
The plugin is available at WordPress.org. Search "FW Real Estate" in your dashboard under Plugins > Add New, install, and activate.
To see the cascade in action, add three or four test listings with different countries and regions, then drop the location search widget or block on a page. The dropdowns populate from your real data, so a handful of test listings across two countries is enough to see the narrowing behaviour work.
For the full feature list and pricing for the MLS/IDX add-on, the product page is at fastw3b.com/products/fw-real-estate.
The honest caveat: if your site is live today with a rented IDX widget and hundreds of listings, switching mid-season carries real continuity risk. The right time to test this is before launch or during a quiet period, when you can import your listings, verify the cascade against your actual locations, and run both side by side before cutting over.
Frequently Asked Questions
Does the cascading search work with listings imported from a CSV file?
Yes. The plugin builds its location dropdowns from whatever is in your database, regardless of how listings arrived. Import a batch via CSV and those locations appear in the dropdowns on the next page load.
Can I show only two levels, say country and city, and skip the region dropdown?
Yes. Both the widget and block settings include a visibility toggle for each dropdown level. Turn off the region dropdown if your listings don't use that field or if you want a shorter form. The remaining dropdowns still cascade correctly.
What happens when I add a listing in a city that wasn't in my database before?
That city appears in the city dropdown automatically. The dropdowns read live from your database each time the page renders, so there's no separate step to add or update location options.
Do the listing fields need to be filled in a specific way for the search to find them?
Each listing needs the country, region, and city fields completed. A listing with an empty city field won't appear in a city-filtered search result. The plugin marks these fields in the listing editor so they're easy to spot during data entry or import mapping.
Does the block version work on classic themes, or only on block themes?
It works on any theme that supports the WordPress block editor, which was introduced in WordPress 5.0. All block themes support it, and most classic themes updated since then do too. If your theme explicitly disables the block editor, use the widget route instead.
The free plugin installs from wordpress.org in a couple of minutes, with no account required and no code downloaded later than the plugin itself. The cascading country-to-region-to-city search, as a sidebar widget and as a native block, is part of that free download.
If your listings come from a live feed rather than direct entry or CSV import, the MLS/IDX add-on handles that connection. It covers RESO Web API providers, CREA DDF, and the UK and European portal feeds. The cascade works the same way once the data is in your database. Board and provider feed fees are billed directly to you, not through Fastw3b.
You can see the full add-on range running at realestatewordpress.fastw3b.com, though that demo shows more than the free plugin installs on its own.
