MLS Import Documentation Aug 6, 2026 · 10 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 do we get our office’s listings to show up automatically on our website?

Use an approved MLS feed to pull your office’s listings into your website. On WordPress, MLS Import can pull those listings and update them each hour. Your team adds listings in the MLS. You do not need to type them into the website again.

Your MLS must allow the feed on your site. Your website team connects it and sets the office filter. That filter tells MLS Import which office’s listings to pull.

Set up your office listings in WordPress

Start with your MLS approval, then test one office listing before you pull the rest.

  1. Ask your MLS for feed access for your brokerage website. Ask who must sign and what fees apply. See who needs to hold the MLS credentials.
  2. Have your website team connect MLS Import. The MLS gives you the login details for the feed. Check the requirements before you buy.
  3. Pull one known office listing. Use the steps below to find the office code the feed sends.
  4. Create an import task, a saved set of rules, with that office code. Choose the listing statuses you may show. Run the first import and let it finish.
  5. Turn on Enable Auto Update every hour for the task. A separate daily check, if you turn it on, removes listings based on your task settings. Ask your website team to set up a server schedule so both jobs run even when no one visits. Follow the auto update guide.
  6. Open your office page. Check the photos, price, and status against the MLS. Check Import History after a later change to confirm an automatic update ran.

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 actually 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.

Use your office listings to bring buyers to your own site

Your office filter gives you the listings for a direct buyer path. Send signs, emails, and social posts to those pages, then check where each inquiry goes. See how to build a direct path for leads from your brokerage’s listings.

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.
  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.

Pro Tip

Build one task per agent when you are creating agent pages. Counts that disagree with the agent’s own totals almost always come from a listing that an earlier, broader task imported first and still owns.

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.

  1. Office task. Filter on ListOfficeMlsId or ListOfficeKey. 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.
  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. MLS Import 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. See the office-plus-neighborhood setup and office and agent pages without duplicate listings.

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.

Can I show only my own listings, or only my office’s?

Yes. Filter on your agent code for your own listings, or on your office code for your whole office, as set out above. Listings from other offices do not come in. Your broker usually signs for the feed, so get your broker’s OK first. Some MLSs license a back office feed for in-house use only, so ask your MLS which feed you may show on a public website and which display rules apply, such as the listing broker credit on each home.

How long will it take to get our office listings on the site?

The wait starts with your MLS approval. Some boards reply in a day. Others take weeks. Once you have the feed login details, your website team can connect MLS Import and test your office filter. Get a launch date after that test passes.

What should we ask our website provider to check?

Ask your website provider to check your MLS access, office filter, and automatic updates before launch. You can send this:

We want our office’s listings to show up on our website without typing them in again. Please check our MLS feed access and office code. Confirm the photos, price changes, and status changes pull through. Tell us the full cost, when updates run, and what you need from our broker.

Can MLS Import help if our website is not on WordPress?

Yes. MLS Import can run on a WordPress site that holds your listing pages. Your website team must plan how buyers reach those pages from your current site. Check the domain and feed approval with your MLS before building that setup.

  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