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

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

  1. Click MANAGE PAGES
  2. Click CREATE NEW PAGE
  3. Type in a name for your new page (ex: "Lonsdale Condos For Sale")
  4. Choose "MLS Search" from the "page type" dropdown
  5. Click CREATE PAGE
  6. Click the PAGE LAYOUT & WIDGETS icon next to the page you created

  7. Click the WIDGET OPTIONS icon on the MLS Search widget

  8. Set your MLS search criteria using the form provided (area, sub-area, property type, price range, bedrooms range, bathrooms range, sqft range, age range)

  9. Set any other widget options such as the default sort order, view, layout, etc. as needed
  10. Click APPLY CHANGES
  11. Click SAVE CHANGES
  12. Click the VIEW EMBED CODE icon next to your page
  13. Click COPY
  14. 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

  1. Click LISTINGS

  2. Click "Add Listing Group"

  3. Type in a name for your new group (ex: "My Favourite Listings")
  4. Click ADD GROUP
  5. Click into the new group

  6. Add a listing manually or import them via MLS number using the forms on the page

  7. Click MANAGE PAGES
  8. Click CREATE NEW PAGE
  9. Type in a name for your new page (ex: "My Favourite Listings")
  10. Choose "Listings" from the "page type" dropdown
  11. Click CREATE PAGE
  12. Click the PAGE LAYOUT & WIDGETS icon next to the page you created
  13. Click the WIDGET OPTIONS icon on the Listings widget

  14. Choose your listing group from the "Listing Group" dropdown

  15. Click APPLY CHANGES
  16. Click SAVE CHANGES
  17. Click the VIEW EMBED CODE icon next to your page
  18. Click COPY
  19. 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

  1. Click BUILDINGS

  2. Click "Add Building Group"

  3. Type in a name for your new group (ex: "Central Lonsdale Condo Buildings")
  4. Click ADD GROUP
  5. Click into the new group
  6. Click "Add a Building" and fill in the form provided
  7. Click MANAGE PAGES
  8. Click CREATE NEW PAGE
  9. Type in a name for your new page (ex: "Central Lonsdale Condo Buildings")
  10. Choose "Buildings" from the "page type" dropdown
  11. Click CREATE PAGE
  12. Click the PAGE LAYOUT & WIDGETS icon next to the page you created
  13. Click the WIDGET OPTIONS icon on the Buildings widget

  14. Choose your building group from the "Building Group" dropdown

  15. Click APPLY CHANGES
  16. Click SAVE CHANGES
  17. Click the VIEW EMBED CODE icon next to your page
  18. Click COPY
  19. 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

  1. Click LISTINGS

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

  3. Click COPY
  4. 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

  1. Click BUILDINGS

  2. Click "Embed Code" on the building you wish to embed. Note: If you don't have a building yet, you can add it manually.

  3. Click COPY
  4. 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.

Still need help? Contact Us Contact Us