---
title: "IDX Broker map search pages, widgets, and acceptance checks"
description: "Plan an IDX Broker map search page, choose a starting view, distinguish display extent from search boundaries, and check the path to an inquiry."
canonical: "https://scalewithsearch.com/articles/idx-broker-map-search-page"
---
## Site navigation

- [Scale With Search](https://scalewithsearch.com/)
- Services
  - Services
    - [AI systems](https://scalewithsearch.com/ai-systems)
    - [Site build](https://scalewithsearch.com/work#site-build)
    - [Whole website fix](https://scalewithsearch.com/work#whole-website-fix)
    - [Content library with SEO](https://scalewithsearch.com/work#content-library)
    - [Working session](https://scalewithsearch.com/audit)
  - Start here
    - [Send your brief](https://scalewithsearch.com/work#send-your-brief)
    - [Example scope](https://scalewithsearch.com/work#review-the-example-scope)
  - [Prices and terms](https://scalewithsearch.com/work#prices-and-terms)
- Industries
  - Real estate
    - [Real estate agents and teams](https://scalewithsearch.com/for/real-estate)
    - [Platforms, ownership, and IDX](https://scalewithsearch.com/for/real-estate/real-estate-website-platforms-ownership-idx)
    - [Search, content, and AI](https://scalewithsearch.com/for/real-estate/real-estate-search-content-ai)
    - [Inquiries, campaigns, and handoffs](https://scalewithsearch.com/for/real-estate/real-estate-website-inquiries-campaigns-handoffs)
    - [Buyer, seller, and local pages](https://scalewithsearch.com/for/real-estate/real-estate-buyer-seller-local-resources)
    - [Rules, privacy, and trust](https://scalewithsearch.com/for/real-estate/real-estate-website-rules-privacy-trust)
  - Browse by business
    - [Trades and home services](https://scalewithsearch.com/for/#group-trades)
    - [Health, wellness, and animal care](https://scalewithsearch.com/for/#group-practices)
    - [Law, finance, and IT](https://scalewithsearch.com/for/#group-professional)
    - [Marketing and SEO agencies](https://scalewithsearch.com/for/#group-agencies)
    - [Shops and manufacturers](https://scalewithsearch.com/for/#group-manufacturing)
    - [Restaurants, shops, studios, and nonprofits](https://scalewithsearch.com/for/#group-local-services)
  - Chiropractic practices
    - [Chiropractic and wellness practices](https://scalewithsearch.com/for/chiropractic-and-wellness-practices)
    - [Chiropractic and physical therapy clinics](https://scalewithsearch.com/for/chiropractic-and-physical-therapy-clinics)
  - [All industries](https://scalewithsearch.com/for/)
- Resources
  - Free tools
    - [AI readiness check](https://scalewithsearch.com/check)
    - [Free tools](https://scalewithsearch.com/tools/)
    - [Free Starter Kit](https://scalewithsearch.com/kit/business-memory-starter-kit.zip)
  - Guides
    - [AI-native library](https://scalewithsearch.com/ai-native)
    - [Industry intelligence](https://scalewithsearch.com/intelligence)
    - [Office job guides](https://scalewithsearch.com/guides/)
    - [Business memory](https://scalewithsearch.com/articles/business-memory-for-ai-agents-guide)
    - [Agent governance](https://scalewithsearch.com/articles/ai-agent-governance-guide-small-business)
    - [Migration and ownership](https://scalewithsearch.com/articles/leaving-vendor-ai-memory-guide)
  - Articles
    - [All articles](https://scalewithsearch.com/articles/)
    - [What changed](https://scalewithsearch.com/changes/)
- About
  - Evidence
    - [Proof](https://scalewithsearch.com/proof)
  - Scale With Search
    - [About](https://scalewithsearch.com/about)
    - [How it works](https://scalewithsearch.com/how-it-works)

# IDX Broker map search for real estate agent websites

Choose whether buyers should open the hosted IDX map page or use a map embedded in a website page. IDX Broker documents both a Map Search page and a portable Map Search widget. [Hosted-page settings, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/34489488047515-Setting-Default-Location-For-Map-Search-Page), [Map Search widget, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/35752222224283-Widget-Map-Search). Checked: 2026.10.22.

A real estate agent should accept the setup through buyer tasks: open the intended area, change criteria, inspect a property, and send a question. The checks below are a proposed implementation brief. They establish no result for a particular account.

## Should you use a hosted map page or an embedded widget?

Choose from the page's purpose and demonstrated behavior. The widget lets a website page contain an interactive map with listing pins and search filters. [Widget purpose, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/35752222224283-Widget-Map-Search). Checked: 2026.10.22.

Ask the provider to show the proposed route before buying additional work. Keep a direct hosted-page link available in the acceptance brief for comparison.

## What should the initial map show?

Start with the area relevant to that page's approved description. Record the intended center, visible extent, and initial filters in the brief.

Ask the provider to demonstrate that view from a fresh visit. A map opening somewhere unexpected is a specific setup issue, even when the map itself loads.

## Where is the hosted page's starting location changed?

IDX Broker documents **Design > Website > Page Templates**, then the Map Search page's preferences and **Search Setup**. [Hosted map configuration, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/34489488047515-Setting-Default-Location-For-Map-Search-Page). Checked: 2026.10.22.

Have the provider record the current view before saving the approved replacement. Use the visible destination in the final check.

## Is the global map center the same setting?

No. The vendor distinguishes global latitude and longitude preferences from the Map Search page's own starting-view settings. [Global versus page settings, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/34489488047515-Setting-Default-Location-For-Map-Search-Page). Checked: 2026.10.22.

Identify the affected map before editing. Ask the provider to explain whether the proposed change applies globally or to the specific search page.

## Does changing the center define the search boundary?

Do not treat the visible center as proof of the result boundary. IDX Broker's query guide distinguishes map center and zoom parameters from parameters used for polygon search. [Map and polygon parameters, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/34489458510619-Search-Queries-For-Custom-Forms-And-Saved-Links). Checked: 2026.10.22.

Compare an expected included property and an expected excluded property when suitable records are available. Record the criteria behind those expectations.

## How should a neighborhood boundary be described?

Use the approved boundary source and state what the search actually represents. Ask the real estate agent to approve the page description before the provider draws a search area.

Keep uncertain boundaries unresolved. Avoid presenting a chosen marketing search area as an official administrative, school, or parcel boundary.

## Can you copy search field names from another website?

Verify them against the account's feed first. IDX Broker warns that MLS field names vary and its custom-query documentation may be outdated. [Query support limitations, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/34489458510619-Search-Queries-For-Custom-Forms-And-Saved-Links). Checked: 2026.10.22.

Ask the provider to demonstrate the supported criteria. Keep guessed field names out of an accepted implementation.

## What should happen when filters change?

Require the result set and displayed criteria to reflect the buyer's selection. Record the starting criteria, changed criteria, and observed outcome.

Include a change that narrows the results and another that broadens them. Use available listings and record the observation date so the reviewer can understand what was tested.

## What should an empty result state communicate?

Ask for a clear explanation that the selected search found no matching records, with a usable way to revise it. Distinguish that state from a failed embed.

Have the provider demonstrate both an expected empty search and a working search. Preserve the criteria and screenshots in the acceptance record.

## Where is a new map widget created?

The vendor's current widget guide uses **Design > Widgets > New > Create New**, then **Map Search**. [Widget creation route, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/35752222224283-Widget-Map-Search). Checked: 2026.10.22.

Confirm that route exists in your account before scheduling implementation. Keep account-specific feature availability UNRESOLVED if the provider cannot demonstrate it.

## Which page address belongs in the widget setup?

Supply the website page where the widget will appear. IDX Broker includes that destination in its widget options. [Widget destination setting, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/35752222224283-Widget-Map-Search). Checked: 2026.10.22.

Agree the intended destination before generating the embed. Record where the code is placed so a later page redesign can preserve it.

## How is the generated widget added to the site?

The vendor instructs builders to paste the generated code into the page's HTML. It notes that a separate map-library snippet may also be required. [Embed instructions, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/35752222224283-Widget-Map-Search). Checked: 2026.10.22.

Ask the website provider to confirm the supported placement for your platform. Accept the public result rather than the presence of a code block in an editor.

## Does the widget support the whole intended search area?

Require a demonstration of the chosen locations and filters. The widget guide distinguishes a single location selection from the advanced arrangement for several locations. [Location options, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/35752222224283-Widget-Map-Search). Checked: 2026.10.22.

Keep the page's claim within the demonstrated search. Do not label a limited setup as complete market coverage.

## Should a cluster outline be called a neighborhood boundary?

No. IDX Broker says clustering outlines are generated algorithmically and do not follow actual city or neighborhood boundaries. [Cluster boundary meaning, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/34489822018331-Map-Pin-Clustering). Checked: 2026.10.22.

Use the outline only as the documented display feature. Keep neighborhood descriptions tied to approved sources outside that visual grouping.

## Are pin clusters available in every account?

Confirm availability before promising them. IDX Broker's clustering article labels the feature as Engage-only. [Clustering availability, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/34489822018331-Map-Pin-Clustering). Checked: 2026.10.22.

Ask the provider to show the controls in the proposed account. Do not infer entitlement from a screenshot or from another real estate agent's website.

## How should listings at the same address be checked?

Inspect whether buyers can reach the individual records. IDX Broker describes pin stacking as a clustering behavior for listings sharing a street address. [Pin stacking, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/34489822018331-Map-Pin-Clustering). Checked: 2026.10.22.

Use an available example when that behavior matters to your inventory. Record missing or inaccessible records as an observed fault, without inventing the cause.

## What does the location button require?

IDX Broker documents enabled SSL and browser permission for its location-based map centering. [Location-button requirements, checked 2026.10.22](https://support.idxbroker.com/hc/en-us/articles/34489450433307-Use-My-Location-For-Map-Search). Checked: 2026.10.22.

Ask the provider to demonstrate the permission request using an authorized test device. Keep location data out of a public repair report.

## What happens if the visitor denies location access?

Require the search to remain understandable without permission. Test the refusal path and confirm buyers can choose an area through the available controls.

This is an acceptance recommendation. The source documentation does not establish your website's refusal behavior, so leave that result unresolved until demonstrated.

## How should a phone map be assessed?

Check map movement, page scrolling, filters, property selection, and returning to the results. Use the proposed public layout and its surrounding navigation.

Record controls that overlap, disappear, or interrupt the buyer task. Ask the provider to repair the specific failure and repeat it under the same conditions.

## What proves the map reaches a useful inquiry?

Open a property from the map and send an agreed marked question using contact details you control. Verify receipt at the expected destination.

Compare the property reference, question, and reply details. Keep the delivery check open when the visitor sees confirmation but the intended recipient cannot find the message.

## What should the acceptance record contain?

Retain the page address, initial view, criteria, boundary description, phone observations, and inquiry result. Name any unavailable test case and the reason.

Separate an implemented setting from an observed result. Inventory and account-specific behavior remain UNRESOLVED where the provider has not demonstrated them.

## How do you brief a map-search repair?

Bring the current search page, intended buyer task, observed failures, and acceptance requirements to the [real estate website scope](/for/real-estate).

For a WordPress installation question, read the [IDX Broker plugin setup checklist](/articles/idx-broker-wordpress-plugin-setup). Keep map configuration, website embedding, and inquiry delivery as named work items in the same brief.

Bring the approved requirements and open questions to the [real estate website brief](/for/real-estate). Request the agreed work through the [written website scope](/work).

- [Find and manage an IDX Broker API key for your real estate website](/articles/idx-broker-api-key-location)
- [IDX Broker custom subdomain and SSL for a real estate agent website](/articles/idx-broker-custom-subdomain-and-ssl)
- [IDX Broker dynamic wrappers for real estate agent websites](/articles/idx-broker-dynamic-wrapper)


## Related: Real estate

- [Find and manage an IDX Broker API key for your real estate website](/articles/idx-broker-api-key-location)
- [IDX Broker custom subdomain and SSL for a real estate agent website](/articles/idx-broker-custom-subdomain-and-ssl)
- [IDX Broker dynamic wrappers for real estate agent websites](/articles/idx-broker-dynamic-wrapper)

----

```text
                  .|########||.                                       .|########||.                                       .|########||.
               |##||.      .||##|.                                 |##||.      .||##|.                                 |##||.      .||##|.
             |#|.              .|#|.                             |#|.              .|#|.                             |#|.              .|#|.
           |#|                    |#|                          |#|                    |#|                          |#|                    |#|
         .#|                        |#.                      .#|                        |#.                      .#|                        |#.
        .#.                          .#|                    .#.                          .#|                    .#.                          .#|
       |#.                            .#|                  |#.                            .#|                  |#.                            .#|
      |#             ......             #|                |#             ......             #|                |#             ......             #|
     .#           ||#########|           #|              .#           ||#########|           #|              .#           ||#########|           #|
    .#.         |######||######|.        .#.            .#.         |######||######|.        .#.            .#.         |######||######|.        .#.
    #.        .##|###|##|#|######|        .#            #.        .##|###|##|#|######|        .#            #.        .##|###|##|#|######|        .#
   ||        |##|#||||||||||||#||#|        ||          ||        |##|#||||||||||||#||#|        ||          ||        |##|#||||||||||||#||#|        ||
   #        |#||||||||||||||||||||#|        #.         #        |#||||||||||||||||||||#|        #.         #        |#||||||||||||||||||||#|        #.
  ||       |#||||||||||||||||||||||#|       ||        ||       |#||||||||||||||||||||||#|       ||        ||       |#||||||||||||||||||||||#|       ||
  #       .#||||||||||||||||||||||||#|       #        #       .#||||||||||||||||||||||||#|       #        #       .#||||||||||||||||||||||||#|       #
 ||   ....|||#||||||##|#|||#|#||##||||....|. ||      ||   ....|||#||||||##|#|||#|#||##||||....|. ||      ||   ....|||#||||||##|#|||#|#||##||||....|. ||
 #.  .  ....|#  ....#|||   ||| .#|||  ....#. .#      #.  .  ....|#  ....#|||   ||| .#|||  ....#. .#      #.  .  ....|#  ....#|||   ||| .#|||  ....#. .#
 #   .  ||||#| .#####||  . .#| .#|||  ||||#   #.     #   .  ||||#| .#####||  . .#| .#|||  ||||#   #.     #   .  ||||#| .#####||  . .#| .#|||  ||||#   #.
.|   |||||  #. |#|||||. ||  #. |#||. .|||||   ||    .|   |||||  #. |#|||||. ||  #. |#||. .|||||   ||    .|   |||||  #. |#|||||. ||  #. |#||. .|||||   ||
||   |....  #. ....|#.      |. ...|. ....||   ||    ||   |....  #. ....|#.      |. ...|. ....||   ||    ||   |....  #. ....|#.      |. ...|. ....||   ||
#.  .||||||##||||||##||####|||||||#||||||#|   .#    #.  .||||||##||||||##||####|||||||#||||||#|   .#    #.  .||||||##||||||##||####|||||||#||||||#|   .#
#    .||####|###########################|.     #    #    .||####|###########################|.     #    #    .||####|###########################|.     #
#      .#||||||.#.|| # |. ..# #| #|||||#|      #    #      .#||||||.#.|| # |. ..# #| #|||||#|      #    #      .#||||||.#.|| # |. ..# #| #|||||#|      #
#      .#|||||| ..  |# ## |#| ...#|#|||#|      #    #      .#|||||| ..  |# ## |#| ...#|#|||#|      #    #      .#|||||| ..  |# ## |#| ...#|#|||#|      #
#      .#|||#|# .# .#| #| ##|.#..#|||||#|      #    #      .#|||#|# .# .#| #| ##|.#..#|||||#|      #    #      .#|||#|# .# .#| #| ##|.#..#|||||#|      #
#      .#||||||############|######|||||#|      #    #      .#||||||############|######|||||#|      #    #      .#||||||############|######|||||#|      #
#   |...||#||||||#||||#|#||||||#|||||#||| |.|  #    #   |...||#||||||#||||#|#||||||#|||||#||| |.|  #    #   |...||#||||||#||||#|#||||||#|||||#||| |.|  #
#. .. ||||# .|||##|.  |#| .|| || .|||#. #|  # .#    #. .. ||||# .|||##|.  |#| .|| || .|||#. #|  # .#    #. .. ||||# .|||##|.  |#| .|| || .|||#. #|  # .#
|| |  ...||  ...##| |  #| .|. |. #####  .. .| ||    || |  ...||  ...##| |  #| .|. |. #####  .. .| ||    || |  ...||  ...##| |  #| .|. |. #####  .. .| ||
|| ||||| || ||||#|  .  |. |. |#. ||||| |#| || ||    || ||||| || ||||#|  .  |. |. |#. ||||| |#| || ||    || ||||| || ||||#|  .  |. |. |#. ||||| |#| || ||
.# |.....#|....|#.||||.|||##.|#|....||.#||.#. #.    .# |.....#|....|#.||||.|||##.|#|....||.#||.#. #.    .# |.....#|....|#.||||.|||##.|#|....||.#||.#. #.
 #.|||||||#############################| ||| .#      #.|||||||#############################| ||| .#      #.|||||||#############################| ||| .#
 ||       ##||#||#||||||#||#||#||#||##.      ||      ||       ##||#||#||||||#||#||#||#||##.      ||      ||       ##||#||#||||||#||#||#||#||##.      ||
  #       .#|||||||||#||#|||||||||||#|       #        #       .#|||||||||#||#|||||||||||#|       #        #       .#|||||||||#||#|||||||||||#|       #
  ||       |#||||||||||||||||||||||#|       ||        ||       |#||||||||||||||||||||||#|       ||        ||       |#||||||||||||||||||||||#|       ||
  .#        |#||||||||||||||||||||#|        #.        .#        |#||||||||||||||||||||#|        #.        .#        |#||||||||||||||||||||#|        #.
   ||        |#||||||||||||||||||#|        ||          ||        |#||||||||||||||||||#|        ||          ||        |#||||||||||||||||||#|        ||
    #.        .######|#|#########|        .#            #.        .######|#|#########|        .#            #.        .######|#|#########|        .#
    .#.         |#####||||#####|         .#.            .#.         |#####||||#####|         .#.            .#.         |#####||||#####|         .#.
     |#           ||########||           #.              |#           ||########||           #.              |#           ||########||           #.
      |#             ......             #|                |#             ......             #|                |#             ......             #|
       |#.                            .#|                  |#.                            .#|                  |#.                            .#|
        |#.                          .#.                    |#.                          .#.                    |#.                          .#.
         .#|                        |#.                      .#|                        |#.                      .#|                        |#.
           |#|                    |#|                          |#|                    |#|                          |#|                    |#|
            .|#|.              .|#|.                            .|#|.              .|#|.                            .|#|.              .|#|.
               |##||.      .||##|                                  |##||.      .||##|                                  |##||.      .||##|
                 .||########||.                                      .||########||.                                      .||########||.

Scale With Search  2026  [scalewithsearch.com](https://scalewithsearch.com)
```
