Standalone mode registers a second post type, Real Estate Agents, and gives every agent a public page with a hero, a bio, their listings and their credentials. You create the profiles; an import never creates one.
The profile is where the details your MLS feed does not carry belong: the portrait, the bio, specialties, languages and the areas the agent covers.
What an agent profile holds
Ten questions people ask before building a roster, answered against what the profile actually supports.
| Element | Supported? | Where it comes from |
|---|---|---|
| Photo | Yes | The featured image is the portrait. Without one the page draws a neutral placeholder rather than breaking. |
| Bio | Yes | The editor content becomes the About section. The hero teaser falls back to the first 42 words of the bio when left empty. |
| Contact details | Yes | The Contact tab: Email, Preferred Phone, Direct Phone, Mobile Phone and Website. Preferred Phone drives the Call and WhatsApp buttons. |
| Social links | No dedicated fields | The Contact tab carries a Website field. There are no separate social profile fields. |
| Active listings | Yes | The Listings section shows the agent’s published properties, with a count above and pagination below. An agent with none reads “No active listings” rather than breaking. |
| Sold listings | Depends on your board | Whatever is published and linked to the agent appears. Whether sold or off market listings may be published at all is your MLS’s rule, not a plugin setting. |
| Schema | Not documented | This page does not document structured data on agent profiles. Do not assume it, check the rendered page. |
| URL | Yes | Each agent gets a public page at their own address on your domain. |
| Block | Yes, the Team Directory block | Puts the roster on any page as a grid of tiles linking to each agent. It can show all agents or a chosen set, order them alphabetically or verified first, and show or hide job title and office name. There is no shortcode equivalent documented. |
| Theme support | Yes, both ways | Standalone mode registers the agent post type on any WordPress theme. In a supported theme the agents are the theme’s own instead. You can override the layout by copying single-mlsimport-agent.php into an mlsimport folder in your theme. |
Before you start
- Standalone mode is selected, which is what registers the agent post type. In a supported theme the agents are the theme’s own.
- You have a portrait image and the contact details you want published.
Create the profile
- Go to Real Estate Agents and click Add New.
- Put the agent’s name in the title. That is what the page heading and every directory tile show.
- Set the featured image to the portrait. Without one the page draws a neutral placeholder rather than breaking.
- Write the full bio in the editor. It becomes the About section of the profile.
- Fill in the Agent Details box below the editor, then publish.
Expected result: the agent has a public page at their own address, and they appear in the Select Agent dropdown on every import task.
The Agent Details box
Five tabs hold everything the page reads.
- Identity: Agent Name, Agent MLS ID, NRDS ID and Title. The title prints above the name as the eyebrow line, for example Broker Associate.
- Contact: Email, Preferred Phone, Direct Phone, Mobile Phone and Website. Preferred Phone is the number the Call and WhatsApp buttons use.
- Office: Office Name, Office Phone, Office MLS ID and Office Address. The office name shows on the hero line beside the MLS ID.
- Profile: Hero teaser, Specialties, Languages and Areas Served. None of these exist in an MLS feed; they are yours.
- Display: Verified agent and Internal note (staff only). The note is never rendered anywhere on the front end.
Fill in what you have. Any block with no value is left out of the page rather than printed empty, so a sparse profile reads as a shorter page and not a broken one.
Leave Hero teaser empty and the hero uses the first 42 words of the bio instead. Write a teaser when the bio opens with a sentence that does not work as a standalone introduction, which is most bios.
What the profile page shows
The layout is fixed: a hero, a sticky sub navigation bar, then a content column beside a sticky contact rail.
- The hero carries the portrait, the verified badge when ticked, the job title, the name, the office and MLS ID line, the teaser, the direct contact details and the Call, Email and WhatsApp buttons.
- About is the bio from the editor.
- Listings is the agent’s published properties as the same cards used everywhere else, with a count above and pagination below.
- Credentials lists the MLS ID, brokerage, email and direct phone, each labelled with the standard field it corresponds to.
The three content sections can be reordered or switched off in Arrange Sections on the Agent tab of MLS Import Design Settings. The same tab sets No. of listings per page, which defaults to 12, and No. of listings per row, which defaults to 3 and drops to fewer on narrow screens on its own.
Attaching listings to the profile
The Listings section shows properties linked to that agent. There are two ways to link them.
- By import task. Pick the agent in Select Agent on the task. In standalone mode the link is rewritten on every run, so changing the task’s agent moves its properties at the next sync.
- Per property. Open a property, go to the Agent & Office tab and set Lead Agent. This is the way to hand one listing to a different agent without building a task for it.
The same choice decides who receives enquiries from that property. Setting Lead Agent back to the MLS feed’s listing agent routes leads to your company email instead, because a feed agent’s personal contact details are not published.
The Team Directory block
The Team Directory page block puts the roster on any page as a grid of tiles, each linking to that agent’s page. It can show every agent or a chosen set, order them alphabetically or verified first, and show or hide the job title and office name on each tile.
Verified agent does more than print a badge. It drives the directory’s verified first ordering and its Verified agents only filter, which makes it a practical way to keep a large roster’s best profiles at the top without maintaining a manual list.
Frequently asked questions
Does an import ever create or update an agent profile?
No. Imports write to properties. Agent profiles are created and edited by you alone, so nothing you type into one is at risk from a sync.
What does the page look like for an agent with no listings yet?
The Listings section still renders and reads “No active listings.” Everything else on the page is unaffected, so a new agent can be published before their import task exists.
Can I use my own design for the agent page?
Yes. Copy single-mlsimport-agent.php into a folder named mlsimport in your theme and edit it there. Your copy is used ahead of the bundled one and survives plugin updates.
Does the WhatsApp button need any setup?
No. It appears whenever Preferred Phone holds a number, and it opens a chat already addressed to the agent by their first name.
Related
- Importing agents and showing listings by agent
- The Team Directory block
- Properties, agents and the eleven taxonomies
- The Design Settings page
- Office page and agent pages without duplicate listings
Send us a link to an agent page that is not reading the way you want and we will tell you which field or setting controls it.