FlexMLS® IDX Plugin


Requirement: To activate the FlexMLS® IDX plugin, you must already be approved by your local MLS and FBS for FlexMLS® IDX. Currently, FBS only provides IDX services to agents and brokers who are members of an MLS that uses FlexMLS® Web. Accordingly, if you are not a member of an MLS organization that uses FlexMLS® Web, this plugin won’t be useful to you.

The FlexMLS® IDX plugin includes six widgets you can add to your side bar, pages and posts. The widgets are:

  1. IDX Slideshow;
  2. IDX Search;
  3. Market Statistics;
  4. 1-Click Location Searches;
  5. 1-Click Custom Searches;
  6. Contact Form.

Live data from the MLS: The IDX and market statistics widgets are all updated with IDX listing and statistics information live from the FlexMLS® Web system used by your local MLS.

Examples and documentation for the widgets can be found here.


  • Add widgets to pages or posts using the included short-code creator.
  • Add graphs to your market analyses using the market stats widget.
  • Add widgets to your sidebar to introduce visitors to your IDX search.
  • Sample IDX slideshow and market stats widget.
  • Sample sidebar design.


This plugin provides 10 blocks.

FlexMLS® IDX Plugin
FlexMLS® IDX Plugin
FlexMLS® IDX Plugin
FlexMLS® IDX Plugin
FlexMLS® IDX Plugin
FlexMLS® IDX Plugin
FlexMLS® IDX Plugin
FlexMLS® IDX Plugin
FlexMLS® IDX Plugin
FlexMLS® IDX Plugin


The easiest way to install the plugin is to use the Add New Plugins function within WordPress and search for FlexMLS® IDX.


  1. Upload the unzipped flexmls-idx folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Go to FlexMLS® IDX > Settings in WordPress and enter your API key information
  4. Add widgets to your sidebar, pages or posts using the tools provided.


Do I need to be approved for FlexMLS® IDX by my local MLS and FBS in order to use this plugin?

Yes, this plugin requires an API key that is only available to approved members.

How do I obtain API credentials?

Please call FBS Broker Agent Services at 866-320-9977 or email idxwordpress@flexmls.com to purchase a key to activate your plugin.


April 25, 2019
Thanks to Brady for walking me through the process and getting this up and running. It works very well and the developer supports their product. What more could you possibly want?
March 19, 2019
This plug-in doesn't work with the number 1 selling WordPress Theme Avada. Some style elements a copied which is nice but for the most part this looks worse than just simple frame-ins. Can't customize to 100% width. This looks horrible but I guess we are stuck with using it in this association
October 5, 2017
I had some issues with the plugin, so I called support. Matt Flatin took care of the issue in about 10 seconds. Great customer support.
July 14, 2017
The plugin seems to be unstable as often getting lines of error codes which disappears on browser refresh. Also seems to have a bad connection to the MLS database. I recommend using another IDX provider.
March 24, 2017
Could not get Flexmls to work with my site.I wanted my money back, but since I went past the 30 days they said no refunds. Make sure everything is working correctly before your 30day is up.
February 16, 2017
The plugin is easy to use and understand, does what it says it will do and looks great. Best of all, the support is outstanding. Definitely recommend this plugin.
Read all 17 reviews

Contributors & Developers

“FlexMLS® IDX Plugin” is open source software. The following people have contributed to this plugin.


Translate “FlexMLS® IDX Plugin” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



Efficiency Updates
* Fixed Map tab on Listing Detail pages


Improvements and New Features
* Auto-completion added to Location Search field in IDX Search Widget

Efficiency Updates
* Schedule A Showing Messages Will Now Deliver To Your Flexmls Account Instead Of A Direct Email
* Problem with some of the widgets not applying in Gutenberg editor in WordPress 5.3
* Fixed IDX Listing Detail Widget Showing A Different Property After API Authentication Token Expired
* Fixed Intermittent PHP Warnings From IDX Slideshow Widget
* DirectoryIterator Reworked To Speed Up The File Load Time
* Reworked PHP count() Method In Listing Detail Pages To Prevent Warnings


Efficiency Updates
* Fixed JS Error Occuring On Some Sites


Improvements and New Features
* Added alt text to IDX/MLS Logo Image Tag
* MLS ID is now appended to the API query for IDX MLS Data Sharing listings
* Ask A Question and Schedule A Showing forms set display property to table in order to prevent styling conflicts
* Placeholder text applied to the Location Search field


Improvements and New Features
* Added Blocks For Each Widget In The New WordPress Gutenberg Editor
* Transparent Background Color Option Added To The IDX Search Widget Options
* Added Option To Show Map or List View By Default In Listing Summary Pages
* Price Change Info Added To Listing Detail Pages
* Videos and Virtual Tours With Non-SSL/HTTPS URLs Will Now Open In New Windows
* “My Search Results” Selected By Default In The “Send Users To:” Option When Added New Widgets
* Added New Setting To Turn Off Select2 Scripts In The Admin and User Areas

Bug Fixes
* Slideshow Flashing and Duplication Problem Fixed
* MLS Number Search Added Back To The Location Search Field In IDX Search Widget
* Slideshow Widget Will Now Show The Correct Number Of Pagination Dots
* Map Tab Will Not Display In Listing Detail Pages If Google Maps API Key Is Not Applied
* Fixed IDX Search To Display Results If Location Search Is Not Displayed


Fixed: Selection of certain location search options wouldn’t apply on search


  • Fixed: Map Setting “Do not load the Google Maps API scrip” is fixed
  • Fixed: When initially installing the plugin, if Yoast SEO is active an error occurs
  • Fixed: Listing Photo modal window on mobile devices adjusted for better fit
  • New: Location Search fields (back-end and front-end) using flexmls Omni service
  • New: Alt and Title tags added to icon images
  • New: IDX Slideshow will now pause if user hovers over listing
  • New: Old Internet Explorer CSS expressions removed for faster loading
  • New: Plugin can now show data-share listings from MLSs that allow it in IDX


  • Added Open Graph tags
  • Added preloading tags to the listing summary and listing detail pages
  • Fixed: Some sites using the IDX slideshow widget were not displaying the Beds, Baths, Sqft Fields.
  • Fixed: Updating the selection of a property sub-type in the IDX Search widget will now display the proper results.
  • Fixed: “Listing Not Available” “Mimic the contents of this page” setting will now save changes.
  • Fixed: IDX Listing Summary widget Display option for Open Houses fixed.
  • Fixed: Location Search field values in the short code generator repeating on some sites.
  • Fixed: Neighborhood widget titles printing “&” in front on some sites.
  • Fixed: Duplicate canonical tags printing when Yoast SEO is being used.

  • Fixed: Fixes recent new listings capabilities for some MLS’s

  • Fixed: Fixes search parameters on search widget

  • Fixed: Issue with saved searches not appearing properly in portal
  • Fixed: Open in new window setting not saving
  • Fixed: No listing results in areas with slashes in their names

  • Fixed: Replaces PHP sessions for hosts that don’t support them
  • Fixed: PHP errors from empty loops
  • Fixed: Javascript error in dashboard for certain slider plugins

  • Fixed: Issue with visitors not able to log into portals
  • Fixed: Portal position on screen
  • Fixed: Portal timing for popup
  • Fixed: Required/force setting for portal dismissal

  • Fixed: Issue where contact widget would not use a custom title in sidebars


  • New: Contact/Lead Generation widget rebuilt for performance
  • New: Honeypot on Lead Generation replaces old captcha
  • New: Background process to clean up old and expired database entries
  • Fixed: Issue where Google map didn’t have height set for some agents
  • Updated: Lead Generation widget rebuilt for speed and better integration with WordPress
  • Updated: More API calls moved to Spark Platform using WordPress functions
  • Updated: Updates README to point to new FlexMLS Settings section


  • New: FlexMLS Options Panel to prepare for additional plugin features coming
  • New: Brand new settings interface
  • New: Under-the-hood improvements to speed and caching
  • Fixed: Error when reusing API credentials before authorization token expires
  • Updated: Caching system naming
  • Updated: Security in settings panel

  • Fixed: Fixes an issue with over-aggressive caching causing listings not to display
  • Fixed: Google map on listings overview page


  • New: Added performance enhancements
  • New: Old database entries cleaned up after cache expiration
  • Fixed: Settings menu and Add Neighborhood menu no longer both highlighted/open when visiting those pages
  • Fixed: Widget constructor error notice
  • Fixed: Google Map script now only loads once
  • Updated: WordPress-integrated API connection method for better performance
  • Updated: Updates caching system for faster page loads (more to come)
  • Updated: WordPress warnings and notices updated and only display to site administrators
  • Updated: Support page in dashboard updated
  • Updated: Installation instructions in README


  • added Map View to the top-right of the search result pages
  • Fixed URL protocol problem with portal login page (only happened in some versions of PHP)
  • Added School District and Area to Location Search field (If MLS has allowed for the field to be used here)
  • Added Page URL To Contact Me Widget Notification Messages


  • Agent/Office Search Widget Is Fixed (Offices only)
  • Listing Detail Fields No Longer Repeating When SEO Plugin Is Installed
  • Removed tags for better mark-up
  • Setting Status Field Not To Show In IDX Search Widget Fixed
  • Removed Dollar Sign From Search Results and Listing Details If There Is Not A Listing Price
  • Listing Address will now only display if it is public
  • The plugin is now HTTPS/SSL friendly
  • Added Flexmls icon to plugin installer
  • Listing Address will display in title bar again for certain themes


  • Some options not applying to widgets in shortcode generator
  • Virtual Tours will now full expand in modal window
  • 1-Click Location Search widget not applying selected IDX link
  • Search Result pages can now handle fields with multiple values
  • Agent list is hidden by default in the shortcode generator
  • “Ask a Question” send button text will change to “Sending…” after being clicked.
  • Plugin is ready for WordPress version 4.4


  • Previous and Next buttons properly navigate in listing details
  • Ask A Question form not displaying
  • Location Search values with special characters are now applicable
  • IDX Search widget selected Property and Sub Types remain selected in pagination links
  • Improvements in handling IDX Slideshow fields
  • Updates to PHP constructors for WordPress 4.3


  • Supplements Added To Listing Detail Page
  • “All” Option Added To Property Type List In Shortcode Generator
  • Listing Status Filter Added To Shortcode Generator (Displays If Your Association Allows Solds In IDX)
  • More Default Sort Options Available
  • MLS # Now Included In Location Search Box Placeholder

Bugs fixed:
* Widget Settings Not Saving Under Appearance > Widgets
* Line Height Value Added To Location Search Box in IDX Search Widget
* New Line Break Added After The URL In The Message Notification Email
* Portal Registration Popup – Pages To Show Checkboxes Now Saving
* Property Type and Property Sub Types Selected Fields Maintained For Both Search Results and Listing Detail Pages.


  • Fixed bug on admin pages that use tabs


  • Captcha to the contact me widget to prevent spam
  • If your association allows sold listings in IDX, you can now allow your users to search for sold listings in the IDX Search widget.
  • IDX Slideshow will properly format the listing address (if shown)
  • Added Line Height value to the location search box. This could only be seen on Internet Explorer
  • PHP warnings property sub-type field have been removed from the IDX Search widget.
  • For those that were experiencing a problem with your theme using font awesome the conflict has been resolved in this version.
  • Location Search box line-height added to prevent placeholder text cut-off in IE
  • Add box-sizing: content-box to CSS file to prevent the close button and navigation arrows from being hidden.


  • Fixed bug that caused api key to be cleared when updating to 3.5.0


  • All widgets are now responsive
  • IDX Slideshow widget will now fade to the next set of listings
  • Property Types are now check boxes in the IDX Search widget, which will allow users to select multiple property types
  • Added Sub-Types to IDX Search widget and the shortcode generator
  • New favorites icons
  • Added mouse rollover text displays to explain each favorite icon
  • IDX Listing Summary widget can now select multiple values from the Location Search box in the shortcode generator
  • New color selector box in the shortcode generator
  • Fixed displaying fields multiple times in the listing detail pages
  • Remove curly brace from 1-Click Location Search HTML Title Attribute(minor)
  • IDX List Number Search Property Type is no longer restricted


  • Made shortcodes work with new tinyMCE api
  • Fixed street address parameters for smart frame results
  • Agent website links now open in a new window
  • Property type is now included in 1-Click location searches
  • Updated CSS for search fields
  • Now caching portal api service


  • Preventing oauth2 api requests when not authenticated


  • Stable for WordPress version 3.8


  • Fixed title for the search results widget
  • Fixed pagination error for OnMarketDate


  • Allowing contact sessions to be saved when php’s autostart is turned on.


  • Bug fix where schedule a showing errors on apostrophe
  • Removed from email tags from email headers
  • Changed Ajax error to be console log message


  • Fixed bug where widgets would not save options on edit


  • Constructor Warning message is fixed


  • IDX links now get looked up individually per summary widget


  • Fixed subdivision lookups
  • Fixed a pagination bug for listing details
  • Added email in schedule a showing messages
  • Added listing carts
  • Added Force Portal Registration Options
  • Added Favorites, Possibilities and Reject Icons for listings
  • Added more sort options to searches
  • Added Status in details and search results
  • Added portal logins
  • Added the portal widget


  • Fixed rare bug on agent search where Array could show as value for email
  • Fixed bug in Field Order on Detail’s page
  • Removed Wildcard for search on Subdivisions


  • Added MLS logo on summary and detail pages
  • Preventing lead generation changes
  • Fixed IE 8 issue where photos showed blue background on listing details
  • Plugin’s directory is now referenced correctly
  • Location searches now show field names on all fields
  • Fixed URL encoding bug on search results prefill


  • Added Office Roster in the shortcode generator
  • Added Documents to Listing Details
  • Plugin no longer activate if cURL is not enabled
  • Subdivisions will now work in shortcodes


  • Full screen photo on details page now shows currently selected photo
  • Now only one photo box will come up when selecting photos
  • Details page now uses the api field ordering service
  • Request a showing button will now work if agent name has an apostrophe
  • Users can now choose how many days for new listings, open houses, etc.
  • Fixed minor bug which would cause possible issues in the future with api requests
  • Removed wildcard from uneccessary parameters in location search


  • Added user side seting for number of search results


  • Allow size changes of slideshow widget
  • Added user side sort by options on search widget


  • Fixed issue with apostrophe in city name
  • Fixed double prefill of mlsareaminor searches


  • Eliminate pass-by-reference to avoid deprecation errors on PHP 5.3
  • Added Questions Button for lead generation to listing detail and search results
  • Support additional IDX compliance rules
  • Added new settings to allow site owner to choose “no available listing” page
  • IDX search widget now complies with any saved search it is based on
  • Changed presentation of rooms in listing details
  • CSS changes to no longer obstruct content in dialogs
  • Fixed padding issue in vertical slideshow
  • Centered text in some search widget buttons


  • Add Street Additional Info to listing addresses


  • Bug fix for Map Overlay searches


  • Wildcard searching for some location search fields


  • Data fix for our Roanoke customers


  • Remove Street Suffix and Street Direction Suffix from list of Property Attributes


  • Added support for WordPress timezones in Listing Detail footer


  • Added MLS# under the address on the listing details page


  • Reverting some meta data changes for greater listing data support


  • Suppressing some additional fields from summary section of details page that should not be shown


  • Changed to use API meta data for labels and values


  • Added new setting to allow multiple summary list widgets on a page if needed. Not recommended for normal use


  • Add MLS Area (minor) to location searching


  • API db improvments
  • Maintain last search criteria in search widget
  • Schedule a Showing
  • Allow address and subdivision location searching


  • Fixed error when searching without a location input box


  • Fixed error where site url confusion on www/non-www


  • Fixed error when commas and dollar signs are entered and get 0 results


  • Fixed trim error on listing detail


  • Fields moved around api return, presentation fix


  • Fix for boolean “main” custom fields as details
  • Fix for bath fields
  • Add the ability to force the display of the listing agent on the WordPress plugin detail page
  • Fix title override from bleeding out
  • Fix links and widgets from being broken when WordPress is referenced from different folder


  • Fix for some broken image paths for IE users
  • Fix for photo film strip for IE users
  • Added some cache garbage collection to help keep the transient cache clean


  • Changes so list prices with decimals display correctly without rounding
  • Fix for listing price searches when using the IDX frame results
  • Fix for the lead generation widget to properly send data and identify notification preference
  • Changed assumed default for listing sorts in listing summary, slideshow and results widgets (assumes “price, high to low” if none given)
  • Small fix to the Settings screen to help eliminate PHP notices in certain environments


  • Improvements to speed up the plugin and API requests
  • Fix to IDX search results widget to allow PostalCode and other location search fields as criteria
  • Fix to photos when using multiple listing detail shortcodes


  • Fix to IDX Search widget so submit button honors selected color in IE
  • Small changes to IDX Slideshow widget to help longer lines fit without wrapping
  • Fix to IDX search results widget to allow ListingId to be used as criteria


  • Fix for issue with PHP error reporting levels and the new IDX Search widget features
  • Flagged third party plugin as having conflicts due to Javascript errors


  • Newly architected PHP API client for better speed, efficiency and features
  • New option in IDX Slideshow to limit shown listings by agent if the site uses an office API key
  • Lots of changes to IDX Search widget to support skins and new options
  • New widget to integrate a summary list of listings (or search results) directly into a WP page
  • New widget to integrate a detailed property report directly into a WP page
  • New shortcodes for the 2 new integrated widgets
  • Expanded and better organized settings screen under Settings > FlexMLS® IDX
  • Ability to turn on display of Listing Office for more control over IDX compliance
  • Added the ability to rename property type labels shown to users (from Settings > FlexMLS® IDX > Behavior)
  • Fixed some issues with the recent change to IDX link pagination


  • Fix for slideshow’s missing/broken pagination


  • Changes needed to support the IDX Links service’s pagination update


  • More minor updates to the IDX slideshow widget to better integrate with Facebook pages
  • Fix to slideshow for broader IE compatibility
  • Improved internal API session management to speed up requests and reduce session collisions (and associated errors)
  • Plugin now correctly handles browser pre-fetching for those that support it
  • Improved JSON parsing code. Now automatically uses native PHP functions if available for much faster JSON parsing


  • Minor update to the IDX slideshow widget to better support Facebook page integration


  • Small Colorbox changes for the photo viewer for better viewing on Facebook pages
  • Fixed a bug with Property Type conditions on My/Office/Company slideshow widgets


  • Added notification option for site owners when a new lead is created
  • Fixed some issues with magic_quotes and how quoted data is submitted to the plugin and API
  • Removed the ability for site owners to disable API caching. Cache can still be cleared manually from the Settings page


  • Added Area and Subdivision to location search where enabled
  • Upgraded Flot and Excanvas for better IE9 compatibility


  • Added protection to block directory viewing on misconfigured servers
  • Added a backup parsing method for URLs when $_GET isn’t available
  • CSS enhancements to better cope with theme conflicts
  • Fixed market statistics graph compatibility issue with IE9
  • Fixed an issue with the default handling of idx_frame settings


  • Restricted portions of the address are now ignored
  • Add new Neighborhood Page feature
  • Changes to photo loading on the IDX Slideshow widget
  • Enhanced IDX Slideshow to include additional, optional fields to show
  • Enhanced IDX Slideshow to make additional calls to API for more slides
  • Enhanced IDX Slideshow to allow sorting
  • IDX Slideshow widget now uses the selected Saved Search link as part of the criteria for pulling listings
  • New “My Office” and “My Company” filters for IDX Slideshow
  • Calls to the FlexMLS® API now include the version of the plugin being used
  • CSS and Javascript changes to better integrate with themes and other plugins
  • Fixed issue with IDX logo being too large in some cases


  • Fixes an issue with the lead generation widget throwing an error in certain environments


  • Contains fixes for some CSS styling conflicts with certain themes
  • Fixes an issue where the location search selection isn’t saved correctly under certain circumstances
  • Fixes for element and widget positioning


  • Contains fix for broken links to Javascript and styles


  • Small fix to correct the displayed IDX logo


  • This is a beta version.