New - Getting Started Guide: MLS®/IDX Widget
This guide is for customers using our MLS®/IDX Widget product launched after June 3, 2024. If you're using our older MLS®/IDX Widget, formerly Listings-Only (IDX) product please read this guide instead.
You can read the steps on this page to learn how to use your MLS®/IDX Widget account, or you can simply watch the complete tutorial video below.
Complete Tutorial Video
Step-by-step Written Instructions
Sections:
- Setting the domain name associated with your account
- How to use embed codes
- Types of embed codes
- Specific instructions for Wordpress and Squarespace users
- Removing trial notice
- Custom coding
- Other settings
- Frequently asked questions
Setting the domain name associated with your account
Your account needs to be associated with one domain name before you can use embed codes. You can set it either on the initial "Step 1) Domain" page, or in "Settings > General > Embed Domain".
Note that this field can accept subdomains, for example "sub.domain.com". It can also be changed later, for when you want to work on a development domain then a separate domain at launch.
How to use embed codes
Our MLS®/IDX Widgets work by loading content via iFrames that you embed into the pages of your third-party (non-RealtyNinja) website.
For example: you have a Wordpress website that you're happy with, but it lacks real estate functionality. You would use this to embed the missing real estate content on your Wordpress website.
Basic instructions on how to use embed codes
To use an embed code, you simply COPY it from your MLS®/IDX Widget account, and PASTE it into the HTML of your website, where you would like it to appear.
Where to find embed codes
When logged into the backend of your account, simply click on "Manage Pages". You'll see a list of pages that can be embedded. The default ones are shown in the screenshot below.
There are icons on the right that allow you to perform actions such as:
Name | Icon | Action |
Delete | Delete a page | |
Page Options | Rename a page | |
Page Layout & Widgets | Set widget criteria (different depending on page type, see section below) | |
View Embed Code | COPY embed code for a page (you'll then PASTE it into your own website's HTML) |
Example: copying an embed code
Example: Pasting embed code into your own website's HTML
Example: MLS/IDX content displaying on your non-RealtyNinja website
Types of embed codes
There are various types of embed codes available. They each serve a unique purpose, and have customizable options available.
MLS Searches
These allow users to browse MLS properties on your website. Listings are automatically updated multiple times per day, and any leads captured get sent straight to you (or your CRM).
We have a collection of help docs related to MLS searches, but the steps below will provide you with a general understanding of how these work.
Note that we create a "Listing Search" page by default, so if you're looking to embed that you can simply do so. The instructions below show you how to create new MLS searches (including niche MLS searches) and embed them on your website.
How to create MLS search embed codes
- Click MANAGE PAGES
- Click CREATE NEW PAGE
- Type in a name for your new page (ex: "Lonsdale Condos For Sale")
- Choose "MLS Search" from the "page type" dropdown
- Click CREATE PAGE
- Click the PAGE LAYOUT & WIDGETS icon next to the page you created
Click the WIDGET OPTIONS icon on the MLS Search widget
Set your MLS search criteria using the form provided (area, sub-area, property type, price range, bedrooms range, bathrooms range, sqft range, age range)
- Set any other widget options such as the default sort order, view, layout, etc. as needed
- Click APPLY CHANGES
- Click SAVE CHANGES
- Click the VIEW EMBED CODE icon next to your page
- Click COPY
- PASTE the embed code onto your own websites HTML where you'd like it to appear
Listings and Listing Groups
These allow users to browse collections of listings on your website. This can include your own active listings, sold listings or custom listing groups. Listings are automatically updated multiple times per day, and any leads captured get sent straight to you (or your CRM).
We have help docs related to active listings and sold listings, but the steps below will provide you with a general understanding of how these work.
Note that we create "Featured Properties" (active listings) and "Sold Properties" pages by default, so if you're looking to embed those you can simply do so. The instructions below show you how to create custom listing groups and embed them on your website.
How to create listing group embed codes
- Click LISTINGS
Click "Add Listing Group"
- Type in a name for your new group (ex: "My Favourite Listings")
- Click ADD GROUP
- Click into the new group
Add a listing manually or import them via MLS number using the forms on the page
- Click MANAGE PAGES
- Click CREATE NEW PAGE
- Type in a name for your new page (ex: "My Favourite Listings")
- Choose "Listings" from the "page type" dropdown
- Click CREATE PAGE
- Click the PAGE LAYOUT & WIDGETS icon next to the page you created
- Click the WIDGET OPTIONS icon on the Listings widget
Choose your listing group from the "Listing Group" dropdown
- Click APPLY CHANGES
- Click SAVE CHANGES
- Click the VIEW EMBED CODE icon next to your page
- Click COPY
- PASTE the embed code onto your own websites HTML where you'd like it to appear
Buildings and Building Groups
These allow users to browse individual buildings (which also display the active listings within them) on your website. Listings are automatically updated multiple times per day, and any leads captured get sent straight to you (or your CRM).
We have help docs related to buildings, but the steps below will provide you with a general understanding of how these work.
Note that we create a "Browse by Building" page by default, so if you're looking to embed that you can simply do so. The instructions below show you how to create custom building groups and embed them on your website.
How to create building group embed codes
- Click BUILDINGS
Click "Add Building Group"
- Type in a name for your new group (ex: "Central Lonsdale Condo Buildings")
- Click ADD GROUP
- Click into the new group
- Click "Add a Building" and fill in the form provided
- Click MANAGE PAGES
- Click CREATE NEW PAGE
- Type in a name for your new page (ex: "Central Lonsdale Condo Buildings")
- Choose "Buildings" from the "page type" dropdown
- Click CREATE PAGE
- Click the PAGE LAYOUT & WIDGETS icon next to the page you created
- Click the WIDGET OPTIONS icon on the Buildings widget
Choose your building group from the "Building Group" dropdown
- Click APPLY CHANGES
- Click SAVE CHANGES
- Click the VIEW EMBED CODE icon next to your page
- Click COPY
- PASTE the embed code onto your own websites HTML where you'd like it to appear
Individual Listings
How to embed individual listings onto your website
- Click LISTINGS
Click "Embed Code" on the listing you wish to embed. Note: If you don't have a listing yet, you can import it by MLS number or add it manually using the options available on the page.
- Click COPY
- PASTE the embed code onto your own websites HTML where you'd like it to appear
Individual Buildings
How to embed individual buildings onto your website
- Click BUILDINGS
Click "Embed Code" on the building you wish to embed. Note: If you don't have a building yet, you can add it manually.
- Click COPY
- PASTE the embed code onto your own websites HTML where you'd like it to appear
Specific instructions for Wordpress and Squarespace users
Removing trial notice
We offer an unlimited free trial that let's you test out our MLS®/IDX Widget embed codes on your website. During trial, you'll see a red notice on the top right corner of your embedded iFrame:
This notice will disappear once you have started a paid subscription for your account.
Note that any attempt to circumvent this notice during your trial period is a violation of our terms of service and will result in account deletion. We regularly check all trial accounts for compliance.
Custom coding
Advanced settings are available for custom CSS styles, header code, footer code and body code. These will be loaded in with all your embedded iFrames.
Head over to "SETTINGS > Custom Code" to use them.
Other settings
Please browse our collection of help docs related to various settings, or get in touch if you have any questions.
Frequently asked questions
Is the content indexed by search engines?
Google tries to associate framed content with the page containing the frames, but they don't guarantee it. If SEO is important, we recommend using our full websites.
Is it a direct MLS® data feed?
We don't provide MLS® data (API) on its own. Embed codes will display our MLS® features and functions on your own non-RealtyNinja website via iframes.
Can I use embed codes from one account on multiple domains?
We allow the usage of embed codes on one domain per account.