Only used with the [rover_idx_listings] shortcode, the format parameter defines how the listings are displayed.
| format | Search Panel | Map | Listings | Notes |
|---|---|---|---|---|
full (default) | Yes | Conditional | Grid | Map appears only if Rover IDX > Customize > Full Page Layout is set to a layout that includes a map, or the shortcode also includes the full_page_layout parameter that includes a map. |
grid | No | No | Grid | Listings only. |
map | No | Yes | No | Map only. |
map_and_grid | No | Yes | Grid | Map and grid together, no search panel. |
carousel | No | No | Horizontal scroll | No search panel or map. Ideal for highlighting a curated set of listings. |
full (default)
[rover_idx_listings]Displays a full page: search panel and a grid of listings. If Rover IDX > Customize > Full Page Layout is configured with a map-inclusive layout, the map is also displayed. This is the same as [rover_idx_listings format="full"]
Full page examples:
Listings in two towns over $750k:
[rover_idx_listings format="full" cities="truro, wellfleet" min_price="750000"]Our listings, but only single family homes
[rover_idx_listings format="full" listings_office_mlsid="*" prop_types="singlefamily"]Single families and condos, with a map (only necessary if the Rover IDX > Customize > Full Page Layout does not include a map)
[rover_idx_listings format="full" prop_types="singlefamily,condo" full_page_layout="map-search-grid"]
grid
[rover_idx_listings format="grid"]Displays only the listings grid. No search panel, no map.
map
[rover_idx_listings format="map"]Displays only a map. No search panel, no grid.
map_and_grid
[rover_idx_listings format="map_and_grid"]Displays a map and a grid together. No search panel.
carousel
[rover_idx_listings format="carousel"]Displays a horizontally-scrolling carousel of listings. No search panel or map. A great way to highlight a specific set of listings — pair with filtering attributes to curate what's shown.
Carousel examples:
Featured listings (a specific listing office):
[rover_idx_listings format="carousel" listing_office_mlsid="*"]New listings (last 7 days):
[rover_idx_listings format="carousel" listing_date="7days"]Waterfront listings:
[rover_idx_listings format="carousel" waterfront="true"]
A Note on Legacy Shortcodes
[rover_idx_listings] is a new Rover IDX 4.0 shortcode, replacing:
[rover_idx_full_page][rover_idx_results_as_table][rover_idx_results_as_map][rover_idx_results]
These legacy shortcodes still work, but we encourage using [rover_idx_listings] going forward.