Real Estate Co-Agents
Listdom Team Addon Documentation
The Listdom Team Addon enables listings to have multiple associated users - essentially creating a team or staff list for each listing. This is useful for scenarios like real estate listings with co-agents, business listings with multiple contacts, or any situation where more than one person should be displayed and reachable for a listing. With the Team addon, listing owners can add other registered users as teammates on their listing, and those team members’ profiles (including contact info) will be shown on the listing’s detail page.
Adding Team Members to a Listing
Section titled “Adding Team Members to a Listing”After activating the Team addon, a new Team module becomes available in the listing submission form (both front-end and back-end). The listing owner (or admin) can add one or more users as team members for that listing:
- Edit or Create a Listing: On the front-end “Add Listing” page (or in WP admin listing edit screen), you will now see a Team section among the listing details.
- Select Team Members: In the Team section, you can add users by selecting their username or email from a dropdown or autocomplete field. Start typing a user’s name - matching registered users will appear. Click to add a user. Repeat to add multiple team members. Each selected team member will typically show as a tag or list item in the field.
- Save the Listing: Once you’ve added the desired team members, submit (or update) the listing. The team member assignments will be saved.
There is no hard limit (by default) to the number of team members you can assign to a listing. However, adding too many could clutter the display, so in practice owners assign a reasonable number of key staff.
Only existing registered users can be added as team members. If a person is not yet a user on your site, they will need an account (even a subscriber-level account) to be selectable in the Team field. Typically, team members might have accounts with roles like Agent, Author, etc., but any user role is acceptable since it’s primarily for display and contact purposes.
Displaying Team Members on the Listing Page
Section titled “Displaying Team Members on the Listing Page”When a listing has team members assigned and the Team addon is active, a Team section can be displayed on the listing’s public detail page. Similar to other listing detail sections, the Team section is controlled via the single listing page settings:
- Go to the Listdom single listing (detail page) settings and locate Team in the list of available elements. Enable it and choose whether to show a title. By default, the Team section title is “Listing Team,” but you can customize this text or hide the title entirely.
- Once enabled, the Team section will appear on all listing pages that have team members assigned (it remains hidden on listings with no team).
When visible, the Team section will list each team member along with key profile information. For each team member, the following details are shown by default:
- Name: The display name of the user, shown as a link to their profile page (if your site has public profile pages for users, e.g., a Listdom user profile or author archive).
- Avatar: The user’s profile picture (WordPress avatar) is shown in a thumbnail.
- Job Title: If the user’s profile has a job title field (Listdom adds a Job Title field in user profiles), it will be displayed below their name.
- Bio: If the user’s profile Biographical Info (description) is filled in, a short bio or description will be displayed.
- Social Icons: Any social media links the user has (as set up in Listdom’s Social Networks settings for user profiles) will appear as icons (for example, Facebook, Twitter links).
- Contact Information: The Team addon can display multiple contact fields for each user:
- Telephone (Tel): The user’s phone number.
- Email: The user’s email address.
- Mobile: A mobile/cell number (if separate from phone).
- Website: A personal or company website URL.
- Fax: Fax number.
You can control which of these contact items are shown for team members. In the single listing element settings for Team, there are toggles for each contact detail:
- Tel: Show or hide the phone number. (Default: Yes, show it, if available.)
- Email: Show or hide the email address. (Default: Yes, show it.)
- Mobile: Show or hide the mobile number. (Default: Yes, show it.)
- Website: Show or hide the website link. (Default: No by default - it’s off unless enabled.)
- Fax: Show or hide the fax number. (Default: Yes, show it.)
These settings apply globally to all listings’ Team sections. If a particular field (e.g., fax) is not relevant to your site, you can keep it disabled so it won’t clutter the team display.
On the front-end, the Team section typically appears as a list of team members with their avatar and details. The layout might be one member per row or in a grid, depending on your theme’s styling. Each team member entry provides multiple ways for visitors to reach out: they can click the email (which opens an email client to send an email), click the phone or mobile number (on mobile devices, this initiates a call), and click the website link to visit an external page. This makes it very convenient for a listing to have, say, two agents both displayed with their direct contact info.
By default, the section title “Listing Team” is hidden (since Show Title is off). If you enable it, it will display as a heading above the list of members - you can change this title text if desired (for example, “Our Agents” or “Team Members”).
Notifications and Team Integration
Section titled “Notifications and Team Integration”One additional feature the Team addon provides is integrating with listing contact notifications. Listdom has a system where, when a visitor sends a message through a listing’s contact form (or any “Contact Owner” action), an email notification is sent to the listing owner. The Team addon can CC all team members on that email:
- In Listdom → Settings → Addons → Team, there is a setting “Contact Notifications”. Turn this on to include team members in email notifications for listing inquiries.
- With this enabled, whenever a contact email is sent to the listing owner (for example, someone fills out the “Contact Owner” form on the listing page), all users listed in the Team will get that email as well (added in CC). This ensures every team member stays in the loop on incoming inquiries.
The Team addon does not otherwise send separate notifications to team members for listing updates; it specifically hooks into the contact emails. Team members can always log into the site and view the listing (though they cannot edit it unless given access by an admin).
To remove a team member from a listing, simply edit the listing and remove that user from the Team field (click the ”×” or backspace their name in the multi-select field), then update the listing. They will no longer be displayed on the front-end and will stop receiving contact notifications for that listing.
Examples
Section titled “Examples”Business with Multiple Contacts
Service Provider Team