Please ensure Javascript is enabled for purposes of website accessibility

NAR IDX Policies

Panoramic shot of shrine over water and garden in Hilo, Hawaii

Please download the following PDF to see NAR’s updated IDX policies.

NAR’s 2015-IDX-Policy

Graphic on accessing listings via MLS or as a Participant. Top example, MLS - access to all listings with your site/app via IDX, Bottom example, Participant - access to listings you own with third party site/app via syndication

  • Yes – An IDX is needed to display or access ALL listings.
  • No – if you want to distribute YOUR OWN listings.
    • Syndication partner
    • Separate entry
  • Participants may only display data on websites or apps that they control.
  • What does “control” mean?
    • A reasonable consumer will believe that the site or app belongs to the participant.
    • The participant can directly manage the site or app, its content, and which listings to display.

Article 10 of MLS Rules and Regulations

  • Who are participants?
    • The Principal Broker
      • –“Participation in IDX is available to all MLS participants engaged in real estate brokerage who consent to display of their listings by other participants.”  ~ MLS Rules 10.05
    • Salesperson may have IDX with participant’s approval

Article 10 of MLS Rules and Regulations.

  • A method of delivering MLS listing data to an app or website controlled by a participant
  • It is presumed that participants in the service agree to allow other participants in the service to display their listings in their own websites or apps.

Article 10 of MLS Rules and Regulations

XML and FTP feeds have been discontinued.  Please subscribe to our RETS IDX or RETS VOW feeds.

Templated IDX

There are more fields available and we will continue to add fields as they go live. As you are using the IDX, you’ll be able to view the source HTML code, and you’ll be able take the “NAME” attribute of the fields you see and use them to construct your links or your quicksearch form.

Field Name GET Name Values Required Notes
Your Unique Identifier idxid string YES this value will be included when you sign up for service. Submitting the wrong IDXID will cause your IDX to malfunction, or display the wrong agent’s branding.
Subdivision subdivision string no
Minimum Bedrooms minbeds integer no
Maximum Bedrooms maxbeds integer no
Minimum Price minprice integer no do not include commas or dollar sign
Maximum Price maxprice integer no
Island island integer maybe required when specifying district, subdivision, and project name.island=1 ==>Oahuisland=2 ==>Mauiisland=3 ==>Big Isleisland=4 ==>Kauai
District District integer maybe these are the numerical values of individual districts and is derived from the taxkey number. This number is the first two digits in the taxkey. For example, the district of North Kohala has a value of 35 while the district of Lihue has a value of 43. in order for this field to be correctly pre-polulated in the select form, you need to also include the island value.Big island:

  • Puna – 31
  • South Hilo – 32
  • North Hilo – 33
  • Hamakua – 34
  • North Kohala – 35
  • South Kohala – 36
  • North Kona – 37
  • South Kona – 38
  • Kau – 39


  • Waimea – 41
  • Koloa – 42
  • Lihue – 43
  • Kapaa/Kawaihau – 44
  • Hanalei – 45


Subdivision subdivision string no This is the official spelling of subdivisions in the public record. You can submit partial spellings of your subdivisions. For example: “Hawaiian Para” for “Hawaiian Paradise Park”. The IDX will search for properties where subdivision contains the string “Hawaiian Para” ignoring capitalization. In order for this field to be correctly pre-polupated in the select form, you need to also include the District value and you must spell out the entire subdivision name. While searching using partial names will work, auto-populating the subdivision name in the subdivision field box requires you to spell out the entire subdivision name, and use correct capitalization.
Condo Project project string no This is the official spelling of condo projects in the public record. In order for this field to be correctly pre-polupated in the select form, you need to also include the District value. Like the subdivision field above, partial spelling will work for searching but in order for the condo project field to correctly pre-populate in the form, the full spelling must be used along with correct capitalization.
Minimum Bathrooms minbaths integer no
Maximum Bathrooms maxbaths integer no
REO/SS/Preforeclosure ssreopf string no ssreopf=any ==>any statusssreopf=none ==>do not include REO/SS/PFssreopf=RL ==>REO ONLYssreopf=SS ==>SS ONLYssreopf=PF ==>PF ONLY
Property Type form string no form=RES ==>Single Familyform=CND ==>Condoform=LND ==>Vacant Landform=COM ==>Commercialform=MTF ==>Multifam;It is possible for one property to have multiple property types. However, you can only query one property type at a time, or all of them at once.
Sort By sorttype string no default is sort by price. available options:sorttype =
pricesorttype =
propty_id ==>mlsnumbersorttype = changed ==>date/time of last data change
Sort Direction sortdir string no default is desc. available options:sortdir =
desc ==>descendingsortdir = asc ==>ascending
Results View resultview string no default: list. available options:resultview=listresultview=map
Listings by a specific Agent listorid integer no type in the id number for the listing agent
Listings by a specific office officeid integer no type in the id number for the listing office
Oceanfront oceanfront char no NULL==>ANY
Y==>Only oceanfront listings
N==>Exclude oceanfront Listings
Property View view string no here’s what a “select” box would look like:<select name=”view”><option value=””>Any</option><option value=”BY”>Bay</option><option value=”CA”>Canyon</option><option value=”CI”>City</option><option value=”CM”>Cemetery</option><option value=”CO”>Coastline</option><option value=”DH”>Diamond Head</option><option value=”FR”>Forest</option><option value=”GA”>Garden</option>

<option value=”GC”>Golf Course</option>

<option value=”MR”>Marina</option>

<option value=”MT”>Mountain</option>

<option value=”NA”>None</option>

<option value=”OC”>Ocean</option>

<option value=”OH”>Ocean Horizon</option>

<option value=”PA”>Pasture</option>

<option value=”RV”>River</option>

<option value=”SR”>Other (remarks)</option>

<option value=”SS”>Sunset</option>

<option value=”SU”>Sunrise</option>

<option value=”WT”>Waterfall</option>


How to change the styling (through CSS)

You can submit the URL of your own CSS file and we will insert it into your site for you. You can then write your own CSS and control the styling of the IDX yourself. Email the URL of your CSS file to our support team and we’ll link it into your site for you.

IMPORTANT NOTE: Submitting your CSS file will cause the original CSS to be completely wiped out. HIS suggests that you copy the existing CSS to your CSS file and then manipulate it from there if you are making small changes.

How to create custom links

You can create custom links to immediately run pre-made specific searches in your idx. For example:

Single Family Homes in South Kohala between $600k and $650k

The corresponding URL will look like this:<YOURIDXID>&island=3&District=36&form=RES&minprice=600000&maxprice=650000

Share pre-made links in social media

If you want to share a specific search result with anyone via social media (email, Facebook, Twitter), you can do so quite easily. Simply use your IDX to perform a search or find a property detail page and then copy the URL of the page you’d like to share and paste it into an email or on a social media platform. If you’re limited on characters or if you want to display a “prettier” URL, you can use a service like and shrink your URL. You’ll be able to post this shortened URL on your social media outlets to share with your public. The IDX will be branded with your information.

Make QR codes for “for sale” signs

Show off your technical savvy by displaying QR codes directly on your home-front signs or anywhere on hard-copy print materials. Simply use your IDX to find the property in question and copy the URL. You’ll then use a QR code generator like kaywa and paste the URL you copied into the on-screen tool. You’ll then be presented with a QR code graphic which you can take and paste into any print material or print out a big version to add to your signage. Users can then see a branded details page on their smartphone.

Make accounts for EXISTING clients

With a FULL IDX, you’ll be able to create an account for your client and the pre-select listings for them that you think they would like. You can then give your client access to the account so that they can review the listings you have chosen for them.

Once your client has access, you’ll be able to see what listings they have bookmarked, and what searches they have saved so that you can have a better idea of what they are looking for when you’re not around.