Status Mapping in MCP

Table of Contents

 

The way listings appear on websites, property update emails, and market report searches is determined by status mapping in MCP. Listings fall under different status groups, which affect their visibility and categorization.

By default, status mapping is set at the Board level, but it can be customized at the Site level upon request.

 

 

---

Types of Status Maps

• Search Status Map – Controls which listings appear in searches.
• Alert Status Map – Determines which listings trigger property update emails and market report updates.
• Display Status Map – Adjusts how statuses are displayed.

---

Search Status Map

Classifies the various listing statuses for multiple listing service (MLS) searches, providing a framework for how each status is interpreted within the Real Geeks system.

The standard categories for listing statuses consist of:

• ACTIVE – Listings appear in standard searches.
• PENDING – Not shown in standard searches but searchable by MLS Number.
• SOLD – Only included in sold searches.

---

Alert Status Map

Controls which listings trigger property update emails and market report searches.

Default Categorization:

Default Categorization defines the automatic grouping and classification of listing statuses within the system. This plays a crucial role in determining how listings are presented in Market Reports and Property Update Emails, based on their designated status mappings.

• ACTIVE → “Active” in Market Reports / “New Active” or “Price Change” in emails.
• SOLD → “Sold” in Market Reports and emails.
• PENDING (or similar) → “Under Contract” in Market Reports and emails.

 

---

Display Status Map

Determines how listing statuses are labeled and presented on the website. This can include:

• Expanding abbreviations for clarity
• Correcting any spelling errors
• Accommodating specific requests from clients

 

---

How to Access Status Maps

Open the account in the MCP Settings → Click Board Settings tab.

 

---

Common Client Requests

Common customer requests often reflect specific needs and preferences for presenting property listings to leads:

• Display Only Active Listings: Clients may request to exclude statuses like Contingent from active listings.
• Remove Sold & Pending Listings: Some clients prefer to hide these statuses from their website.

Displaying Only Active Properties on a Website

Clients may define “Active” differently. Some want to exclude statuses like Contingent from appearing as active listings.

---

How to Remove “Contingent” and Other Active-Like Statuses

• Check current Status Mapping
  • The client’s Search Status Map may currently include multiple statuses under ACTIVE, such as:
    
    

    {
      "ACTIVE CONTINUE TO SHOW": "ACTIVE",
      "ACTIVE": "ACTIVE",
      "SOLD": "SOLD",
      "CONTINGENT": "ACTIVE",
      "PENDING": "PENDING"
    }

• Update the Search Status Map

  • If the data appears grayed out and cannot be edited, follow these steps:

    • Go to the MCP Board list and find the client’s board.
    • Copy the Search Status Map data from the MCP Board.
    • Return to the site’s MCP Settings and paste the copied data into the Search Status Map field.
  • Adjust the mapping to exclude Contingent from ACTIVE and move it to PENDING:
• Remove unnecessary mappings from the Alert Status Map, if present.
• Click Save.

---

Removing Sold and Pending Listings from a Website

Certain clients may choose to completely exclude Pending and Sold listings from their website. To achieve this:

• Remove Sold Search from Advanced Search Page (if applicable).
• Update the Search Status Map:
• Go to MCP Settings → Board Settings.

  • If the data appears grayed out and cannot be edited, follow these steps:

    • Go to the MCP Board list and find the client’s board.
    • Copy the Search Status Map data from the MCP Board.
    • Return to the site’s MCP Settings and paste the copied data into the Search Status Map field.
• Delete SOLD and PENDING mappings from both:
  • Search Status Map
  • Alert Status Map
• Click Save.

Example:

Before (Includes Sold & Pending)

{
  "SOLD": "SOLD",
  "ACTIVE KICK OUT": "ACTIVE",
  "ACTIVE": "ACTIVE",
  "ACTIVE CONTINGENT": "ACTIVE",
  "ACTIVE OPTION CONTRACT": "ACTIVE",
  "PENDING": "PENDING"
}

After (Sold & Pending Removed)

{
  "ACTIVE KICK OUT": "ACTIVE",
  "ACTIVE": "ACTIVE",
  "ACTIVE CONTINGENT": "ACTIVE",
  "ACTIVE OPTION CONTRACT": "ACTIVE"
}

 

---

How to Remove Sold & Pending Listings from Property Update Emails

Clients may want to display sold listings on their website while excluding them from property update emails. Here’s how to do that:

How to Disable Sold/Pending in Emails

• Go to MCP Settings → Click Board Settings.
• Set Expand Searches For Alerts to False.
  
  
• Click Save.

Client Response Template

Below is a suggested email template to send to the client after finalizing the changes:

Hi  {{ticket.requester.first_name}},

I’ve updated your settings so that property update emails only include Active listings. However, if a lead explicitly saves a Sold search, they will still receive Sold listings.

Let me know if you need any further adjustments!

 

---

Troubleshooting & FAQs

I get an error when trying to save the status maps

If you see an error message, there may be an extra comma that needs to be removed or a missing quote/colon that needs to added.

Mapping by Other Status Fields?

We can only map by the status field provided in the board’s MLS feed. If a client requests mapping based on a sub-status, a custom field must be created.

How to Check If a Board Includes Sold Listings

Some MLS boards don't include sold listings in the data feed. Due to this, we are unable to display sold listings for several listings. Other times, sold listings are only available on a per-client basis.

To see if there are sold listings in the database, go into the database and run the following command:

db.properties.distinct("status",{board:<BOARD_NUMBER>,enabled:true}).sort()

in which <BOARD_NUMBER> is the number of the MLS board in rope that the client is associated to.

If sold listings are included in the database but isn't included within the Search Status Map field, please check with someone in our Boards & Approval department (e.g. Lida or Tori) on whether the MLS board only allows Sold listings on a per-client basis before making any changes to the Search Status Map field for the client.

 Check with Boards & Approval (e.g., Tori) before making changes.

Can we use other Search Status groups?

Our status fields have many other possibilities (according to the developer who had implemented it). It does allow you to categorize the statuses into other groups (e.g. a status group called "Contingent"), but our system may not be implemented to support those groups.

So far, the only status groups our system supports are "ACTIVE", "PENDING" and "SOLD".