[sr_listings] – Show listings anywhere on your site

The [sr_listings] short-code is the easiest way to show your MLS listings on any page or post on your website. The short-code can be used “as-is”, or you can add search filters to control which listings are shown; for example by price range, agent ID, or neighborhood. The search results are shown on a map to make visualizing the listings easy.

This short-code is most commonly used with the [sr_search_form] short-code to create a cohesive experience for your visitors to search and view listings. See the syntax section below to get started, then try adding options and search filters!

Syntax

Basic usage:

[sr_listings]

With options and filters:

[sr_listings minprice="1000000" agent="agent1; agent2"]

Options

The [sr_listings] short-code takes options to change the layout and behavior of the listings and map.

NameDefaultDescriptionExample
grid_viewfalseShow results in a grid/tile view with 3 per row, instead of a list[sr_listings grid_view="true"]
show_maptrueShow the matching results on a map.[sr_listings show_map="true"]
map_positionmap_aboveConfigure where the map is shown: list_only, map_only, map_above, map_below.[sr_listings list_view="true"]

Search filters

Filters can be used to control which listings are searched, how many are visible per page, and many more things. You can use multiple filters at the same time, and some filters can take multiple values!

This short-code supports all of our API parameters. Check out the API docs here for a full list of search filters.

NameDefaultMultipleDescriptionExample
vendornullfalseThe RETS vendor to search (required with multi-mls accounts).vendor="har"
sortModifed, descendingfalseSort the listings on list date, price , number of bedrooms, or number of bathrooms.sort="-listdate"
limit25falseThe number of results to show per page (max 500).limit="500"
qnulltrueA textual keyword search that searches MLS #, street address, city, zip code, subdivision, and MLS area.q="Houston"
statusActive; PendingtrueFilter listings by status.status="Active; Closed"
typeResidential; RentaltrueFilter listings by property type.type="Condominium; Rental"
subtypeTownhouse; CondominiumtrueFilter listings by property sub-type.subtype="Townhouse; Condominium"
agentnulltrueFilter listings by agent MLS ID(s).agent="agent1; agent2"
brokersnulltrueFilter listings by broker MLS ID(s).brokers="office1; office2"
salesAgentnullfalseFilter listings by a sales agent MLS #.salesAgent="AGENTID"
minpricenullfalseFilter listings by a minimum price.minprice="500000"
maxpricenullfalseFilter listings by a maximum price.maxprice="1000000"
minareanullfalseFilter listings by a minimum living area.minarea=2500
maxareanullfalseFilter listings by a maximum area.maxarea=10000
minbedsnullfalseFilter listings by a minimum number of bedrooms.minbeds="3"
maxbedsnullfalseFilter listings a maximum number of bedrooms.maxbeds="5"
minbathsnullfalseFilter listings by a minimum number of bathrooms.minbaths="2"
maxbathsnullfalseFilter listings by a maximum number of bathroroms.maxbaths="5"
maxdomnullfalseFilter listings by a maximum days on market.maxdom="30"
minyearnullfalseFilter listings by a minimum year built.minyear="2015"
maxyearnullFilter listings by a maximum year built.maxyear="1984"
minacresnullfalseFilter listings by a minimum number of acres.minacres="5"
maxacresnullfalseFilter listings by a maximum number of acres.maxacres="100"
minGarageSpacesnullfalseFilter listings by a minimum number of garage spaces.minGarageSpaces="2"
maxGarageSpacesnullfalseFilter listings by a maximum number of garage spaces.maxGarageSpaces="4"
waternullfalseFilter listings by a waterfront (or “true” for all waterfront listings).water="Lake Name"
citiesnulltrueFilter listings by a city.cities="Houston; Chicago"
statenulltrueFilter listings by a state.state="TX"
postalCodesnulltrueFilter listings by a postal code.postalCodes="77001; 77002"
neighborhoodsnulltrueFilter listings by a neighborhood.neighborhoods="Oak Ridge; River Oaks"
countiesnulltrueFilter listings by a county.counties="Montgomery; Harris"
featuresnulltrueFilter listings by interior features.features="Wet Bar; High Ceiling"
exteriorFeaturesnulltrueFilter listings by exterior featuresexteriorFeatures="Patio; Outhouse"
idxnullfalseSpecify the IDX display requirements for the listings.

idx=null (default)
– IDX address display must be true
– IDX listing display must be true
idx=listing
– IDX address display is ignored
– IDX listing display must be true
idx=address
– IDX address display must be true
– IDX listing display is ignored
idx=ignore
– IDX address display is ignored
– IDX listing display is ignored

Please check with your MLS or data feed provider on the rules and requirements for displaying restricted listings.
idx="listing"

Check out the API docs here for more information and examples of the search parameters, and possible values for things like type and subtype.

Example

Raw short-code:

[sr_listings grid_view="true" minprice="1000000" maxprice="5000000"]

Output:

Active
  • Located in Oak Ridge
  • Built in 1966
  • MLS #: 77304327
  • 4 Bedrooms
  • 3 Full baths
  • 2,991 SqFt
More details Listing by Nyssa Rice
Pending
  • Located in Tomball
  • Built in 1961
  • MLS #: 87082351
  • 5 Bedrooms
  • 4 Full baths
  • 2,991 SqFt
More details Listing by Amanda Santana
Pending
  • Located in Tomball
  • Built in 1986
  • MLS #: 65770160
  • 6 Bedrooms
  • 4 Full baths
  • 651 SqFt
More details Listing by Ian Fletcher
Active
  • Located in Tomball
  • Built in 1993
  • MLS #: 27753544
  • 1 Bedrooms
  • 3 Full baths
  • 4,054 SqFt
More details Listing by Shoshana Phelps
Pending
  • Located in Oak Ridge
  • Built in 2004
  • MLS #: 6253995
  • 2 Bedrooms
  • 2 Full baths
  • 1,036 SqFt
More details Listing by Mark Mcneil
Active
  • Located in Katy
  • Built in 1957
  • MLS #: 98433036
  • 6 Bedrooms
  • 3 Full baths
  • 4,985 SqFt
More details Listing by Mark Mcneil
Active
  • Located in Tomball
  • Built in 2003
  • MLS #: 6323997
  • 2 Bedrooms
  • 6 Full baths
  • 1,562 SqFt
More details Listing by Bruce Boyle
Pending
  • Located in Cypress
  • Built in 1959
  • MLS #: 89734192
  • 4 Bedrooms
  • 5 Full baths
  • 1,452 SqFt
More details Listing by Echo Mayer
Active
  • Located in Oak Ridge
  • Built in 1979
  • MLS #: 4249521
  • 2 Bedrooms
  • 1 Full bath
  • 2,130 SqFt
More details Listing by Echo Mayer
Pending
  • Located in Cypress
  • Built in 1965
  • MLS #: 53415660
  • 5 Bedrooms
  • 5 Full baths
  • 1,990 SqFt
More details Listing by Hyacinth Rollins

This is custom disclaimer text that can show when the data was last updated: 2024-10-07T20:36:17+00:00
Close Menu