MLS Import Documentation Aug 6, 2026 · 9 min read

Importing one agent’s or one office’s listings

L
laura perez
I’m Laura Perez, your friendly real estate expert with years of hands-on…

How importing by office or agent works

An import task can bring in only the listings of one office or one agent. Enter the office code in ListOfficeMlsId, or the agent’s ID in ListAgentMlsId. With Enable Auto Update every hour turned on, new listings and changes come in each hour.

To show your own listings and the rest of the market on one site, you use two kinds of task: your office or agent task, and general tasks that exclude your office or agents. The sections below show each step.

Set up your office or agent listings

  1. Connect MLSImport to your MLS feed. See who needs to hold the MLS credentials.
  2. Find the office code or the agent ID your feed uses, with the steps in Find the identifiers your feed uses below.
  3. Create an import task. Enter the office code in ListOfficeMlsId, or the agent’s ID in ListAgentMlsId, and choose the statuses in Select Status.
  4. Press Save Draft. The task shows how many listings it finds. Then run the first import and let it finish.
  5. Turn on Enable Auto Update every hour. See the auto update guide.
  6. Open one of your listings and check the photos, price and status against the MLS.

Five fields on an import task restrict it to one agent or one office: ListAgentKey, ListAgentMlsId, BuyerAgentMlsId, ListOfficeKey and ListOfficeMlsId. Which of them work depends on your MLS, because feeds differ in what they populate.

Start by finding out which identifiers your feed carries. Filtering on a field your MLS leaves empty returns nothing, and looks identical to a wrong identifier.

If your office’s new listings show up on Zillow but not on your site, check more than the office code. Follow the missing office listings checklist to check the feed, display rules, auto update, and your office page.

Find the identifiers your feed uses

The reliable method is to import one known listing and read the values off it.

  1. Find one listing belonging to the agent and copy its MLS number.
  2. Create an import task with a single filter: ListingId set to that number. Leave every other filter empty.
  3. On the Select Import fields tab, make sure ListAgentKey, ListAgentMlsId, BuyerAgentMlsId, ListOfficeKey and ListOfficeMlsId are among the imported fields. They can be marked private so they never show publicly.
  4. Run the import, then open the imported property in wp-admin and read the values in its custom fields.
  5. Note which ones hold a value. Those are the identifiers you can filter on.

A typical result has some fields filled and others blank. A feed might return a long hexadecimal ListAgentKey and a short office code in ListOfficeMlsId, while leaving ListAgentMlsId empty. In that case filter by ListAgentKey, and treat the empty fields as unavailable on that MLS.

Pro Tip

Keep the single listing task after the discovery run. Clearing ListingId and entering the identifier you found converts it into the production task, and you have already proved the fields exist in your feed.

Listing agent and buyer agent are separate tasks

A listing carries the listing agent in one field and the buyer agent in another. A single listing is rarely both, so a task filtered on a listing agent identifier and a buyer agent identifier at once returns zero results. Every filter has to match at the same time.

  1. Task one filters on ListAgentMlsId or ListAgentKey. It returns the listings where that agent represented the seller, across the statuses you selected.
    Import task with the agent ID entered in ListAgentMlsId
  2. Task two filters on BuyerAgentMlsId only. It returns the transactions where that agent represented the buyer.

Two tasks give two counts that add up correctly. One task with both fields set gives zero, which reads like a broken connection and is not.

Excluding an agent or an office

Four fields exclude instead of include: Exclude listings with ListOfficeMlsId, Exclude listings with ListOfficeKey, Exclude listings with ListAgentMlsId and Exclude listings with ListAgentKey.

The main use is separating tasks that would otherwise collide. If one task imports your own office by ListOfficeMlsId, add that same value to the exclude field of your general market task. Each listing then belongs to exactly one task, which keeps the agent assignment and the counts consistent.

General import task with the office code entered in Exclude listings with ListOfficeMlsId

For agents, enter their IDs in Exclude listings with ListAgentMlsId. Separate several IDs with a comma and no space.

General import task with two agent IDs entered in Exclude listings with ListAgentMlsId

Pro Tip

Create each agent on your site, then pick that agent in Select Agent on the agent’s import task. Every listing the task imports is assigned to that agent, so the contact form on the listing sends leads to that agent’s email.

Your office’s listings plus the wider market or a few neighborhoods

One site can show your office’s listings and the rest of your market, or your office’s listings plus a few neighborhoods. You build separate import tasks. A single task set to your office and one neighborhood pulls only your office’s homes in that neighborhood.

This video shows the office task, the agent tasks and the exclude fields:

  1. Office task. Filter on ListOfficeMlsId or ListOfficeKey. If your brokerage has more than one office code, make one task per code. Each filter takes one value. If your team is only part of a bigger office, the office code pulls the whole brokerage, so build one task per agent on your team instead and pick that agent in Select Agent.
    Office import task with the office code entered in ListOfficeMlsId
  2. Market or neighborhood tasks. For the wider market, filter by city, county or price. For a few neighborhoods, build one task per area with Subdivision Name, MLS Area Major or ZIP code. Subdivision Name and MLS Area Major are free text and only work when your MLS fills them in, so test one known home first. Put your office code in Exclude listings with ListOfficeMlsId on each of these tasks.
  3. First run. Run the office or agent tasks before the market tasks the first time. On WPResidence, Houzez and Real Homes, the task that creates a listing sets its agent. Then turn on Enable Auto Update every hour for each task.

Every imported home is a normal listing page on your site, so your search and map show all tasks together. No home shows up twice. MLSImport knows each listing by its MLS number, so a second task that finds a home already on the site updates it instead of adding a copy. One task imports at most 10,000 listings, so split a big market by city or price band. Showing other brokers’ homes needs an IDX feed your MLS has approved, so check that before you build the market task. Some sellers ask that their home stay off the internet. If your MLS asks for it, an import task can filter on InternetEntireListingDisplayYN to leave those homes out. See MLS display rules and internet flags. See the office-plus-neighborhood setup and office and agent pages without duplicate listings.

If, as an agent or office, you want to keep your closed listings

The MLS stops sending a listing some time after it sells, and the daily check then removes it from your site. To keep your own sold listings, set your office or agent task like this:

Select Status: Active, Pending and Closed
Protected Statuses: Closed

Office or agent import task with Active, Pending and Closed selected, and Closed in Protected Statuses

Protected Statuses means never delete, so your closed listings stay on your site after the MLS stops sending them. Only Closed is protected, so a listing of yours that is withdrawn or expires is still removed.

On the general tasks, leave Protected Statuses empty, so listings from other offices are removed when they sell, expire or are withdrawn, as the MLS requires. Please check with your MLS that you may keep your own sold listings. See Protected Statuses.

If it does not work

  1. The task finds zero listings. Remove every filter except the agent identifier. If the count is still zero, that field is empty in your feed. Go back to the single listing method and read which fields have values.
  2. The count is far lower than expected. Check Select Status. A task set to Active only will not count that agent’s pending and closed transactions.
  3. An agent’s page is empty or shows too few homes. Start with one missing home and its MLS number. Search for it in Import History. If it is not there, the task’s filters or statuses left it out, or the agent field is empty in your feed. An empty page does not prove the agent has no active listings.
  4. The agent’s page shows listings owned by another task. The listing was imported first by a broader task. Delete those properties from the Tools tab and re-import them with the agent specific task.

Frequently asked questions

Where do I get the agent or office identifier if importing a listing is not an option?

Ask your MLS. They issue the values and can tell you which identifier your feed publishes for agents and offices. We cannot look them up, because they belong to your MLS account rather than to the plugin.

Does filtering by agent create an agent profile on my site?

No. The filter decides which listings are imported. Whether a property links to an agent profile depends on your theme and on the agent settings of the import task.

Can one task import two agents?

Not through these fields, since each takes one value and all filters must match together. Create one task per agent, which is also the setup that keeps counts and assignment correct on agent pages.

The office filter works but the agent filter does not. Is that normal?

Yes, it happens often. Feeds vary in which identifiers they populate, and office fields are filled more consistently than agent fields on some MLSs. Filter by office and, where you need one agent, narrow further with a status or city filter.

Will new office listings show up and update without anyone clicking Import?

Yes, once the task has finished its first import and Enable Auto Update every hour is on. Each hourly run asks your MLS for listings that match the task’s filters and changed since its last check. It updates the homes already on your site and adds any listing that newly matches, such as a new listing under your office code. A brand new task is skipped until you run it once by hand.

  1. Controlling which listings are imported
  2. Avoiding overlapping import tasks
  3. Title format, property status and owner
  4. What an import task is

If the identifiers are populated and the task still returns nothing, send us the task and we will run the query against your feed.

L
About the author
laura perez
I’m Laura Perez, your friendly real estate expert with years of hands-on experience and plenty of real-life stories. I’m here to make the world of real estate easy and relatable, mixing practical tips with a dash of humor. Partnering with MLSImport.com, I’ll help you tackle the market confidently—without the confusing jargon.
All posts by laura