Parameters

All parameters are passed as query strings in the iframe src URL:

https://www.stay22.com/embed/gm?aid=<AID>&address=Bell+Centre+Montreal&checkin=2026-08-15

Try it

Toggle parameters on and off to see how they affect the map in real time.

Enter your Affiliate ID to use the playground

Don't have one? Just hit Go. We'll use demo_affiliate_id as a placeholder.

Required

Parameter	Type	Required	Default	Description
`aid`	string	Yes	—	Your Stay22 affiliate ID. Signup for free here.

Location

At least one location parameter is needed. Coordinates are the most precise.

Parameter	Type	Required	Default	Description
`address`	string	No	—	Destination address or place name. URL-encode spaces as `+` or `%20`.
`lat`	number	No	—	Latitude. Use with `lng`. Takes priority over `address`.
`lng`	number	No	—	Longitude. Use with `lat`.

Dates

Parameter	Type	Required	Default	Description
`checkin`	string	No	—	Check-in date in `YYYY-MM-DD` format.
`checkout`	string	No	—	Check-out date in `YYYY-MM-DD` format.

Guests

Parameter	Type	Required	Default	Description
`adults`	number	No	—	Number of adult guests.
`children`	number	No	—	Number of children.
`infants`	number	No	—	Number of infants.
`rooms`	number	No	—	Number of rooms. Defaults to 1.
`bedrooms`	number	No	—	Number of bedrooms.
`beds`	number	No	—	Number of beds.
`bathrooms`	number	No	—	Number of bathrooms.

Tracking

Parameter	Type	Required	Default	Description
`campaign`	string	No	—	Campaign ID for tracking. To know where this map is being embedded, and where the booking came from.
`gclid`	string	No	—	Google Click ID for AdWords attribution.

Viewport & Bounds

Control the map viewport, zoom level, and visible area.

Parameter	Type	Required	Default	Description
`zoom`	number	No	—	Force a specific map zoom level. Higher numbers = more zoomed in. Typical range: `1` (world) to `18` (street level). Defaults to `16`.
`freezeviewport`	boolean	No	—	Lock the map viewport. Prevents automatic adjustments when filters change or results load.
`nelat`	number	No	—	Northeast latitude of a bounding box. Use with `nelng`, `swlat`, `swlng`.
`nelng`	number	No	—	Northeast longitude of a bounding box.
`swlat`	number	No	—	Southwest latitude of a bounding box.
`swlng`	number	No	—	Southwest longitude of a bounding box.
`scroll`	string	No	—	Scroll/zoom behavior on the map. Options: `enabled`, `disabled`.

GPX Trails

Render a route or trail on the map from a GPX file.

Parameter	Type	Required	Default	Description
`gpx`	string	No	—	URL to a GPX file. Renders the trail as a polyline on the map. Must be hosted on HTTPS. You may need to configure CORS headers on the hosting server to allow the iframe to fetch it.
`gpxlinecolor`	string	No	—	Trail line color. Hex without `#`. Defaults to `45aaf2`.
`gpxlineopacity`	number	No	—	Trail line opacity from 0 to 1. Defaults to `1`.
`gpxlinethickness`	number	No	—	Trail line thickness in pixels. Defaults to `4`.

Filters

Parameter	Type	Required	Default	Description
`min`	number	No	—	Minimum price filter.
`max`	number	No	—	Maximum price filter.
`priceper`	string	No	—	Price display mode. Options: `nightly`, `total`.
`minstarrating`	number	No	—	Minimum star rating filter.
`minguestrating`	number	No	—	Minimum guest rating filter.
`limit`	number	No	—	Maximum number of results to display. Min 5, max 99.

Visual

These change how the map looks. Toggle them in the playground above to see what each one does.

Parameter	Type	Required	Default	Description
`mapstyle`	string	No	—	Map visual style. Options: `dark`, `light`, `satellite`. Defaults to standard.
`maincolor`	string	No	—	Primary accent color. Hex value without the `#` (e.g. `ff5a5f`).
`invmode`	string	No	—	Inventory mode. Options: `accommodation` (default), `experience`.
`listviewexpand`	boolean	No	—	Show list view alongside the map. The iframe must be wider than 400px for the list to appear.
`viewmode`	string	No	—	Initial view. Options: `map`, `listview`, `all`.
`markerimage`	string	No	—	URL for a custom marker icon on the destination pin.
`navimage`	string	No	—	URL for a custom navigation icon.
`dotlistings`	boolean	No	—	Show listings as dots on the map instead of price markers.

Colors

All hex values, without the # prefix.

Parameter	Type	Required	Default	Description
`fontcolor`	string	No	—	Primary font color.
`fontcolorsub`	string	No	—	Secondary font color.
`hotelscolor`	string	No	—	Hotel marker color.
`hotelsfontcolor`	string	No	—	Hotel marker font color.
`rentalscolor`	string	No	—	Rental marker color.
`poibgcolor`	string	No	—	POI background color.
`bordercolor`	string	No	—	Border color.
`loadingbarcolor`	string	No	—	Loading bar color.
`chpincolor`	string	No	—	Custom pin color.
`chpinfontcolor`	string	No	—	Custom pin font color.

Custom Content

Parameter	Type	Required	Default	Description
`poi`	string	No	—	Custom points of interest as a URL-encoded JSON array. Each object supports: `lat`, `lng` (position), `name` (pin label), `desc` (hover text), `url` (click destination), `img` (icon URL), `size` (1-5), `disablehover` (skip hover card). Typically set programmatically.
`fitmaptopoi`	boolean	No	—	Fit the map bounds to include all POI positions.
`hotels`	string	No	—	Custom hotel listings as a URL-encoded JSON array passed in the query string. Typically set programmatically rather than by hand.
`title`	string	No	—	Widget title override. Pass `null` to remove.
`customfontlink`	string	No	—	URL to a custom font (e.g. Google Fonts link).
`customfont`	string	No	—	Custom font name. Requires `customfontlink`.

Provider Selection

Parameter	Type	Required	Default	Description
`hotelsapi`	string	No	—	Hotel API provider override (e.g. `booking`, `expedia`).
`rentalsapi`	string	No	—	Rental API provider override (e.g. `vrbo`).

Listing Filtering

Show, hide, or feature specific listings by their provider IDs. All ID lists are comma-separated.

Parameter	Type	Required	Default	Description
`showhotels`	boolean	No	—	Show hotel listings.
`skiphcids`	string	No	—	booking.com Hotel IDs to exclude (comma-separated).
`onlyhcids`	string	No	—	booking.com Only show these hotel IDs (comma-separated).

UI Toggles

Hide specific UI elements. All are boolean — set to true to hide.

Parameter	Type	Required	Default	Description
`hideenlargemap`	boolean	No	—	Hide the fullscreen/enlarge button.
`hidesettings`	boolean	No	—	Hide the settings button.
`hidecurrency`	boolean	No	—	Hide the currency selector.
`hidelanguage`	boolean	No	—	Hide the language selector.
`hidesearchbar`	boolean	No	—	Hide the search bar.
`hidefilters`	boolean	No	—	Hide all filters.
`hidepricefilter`	boolean	No	—	Hide the price filter.
`hidecheckinout`	boolean	No	—	Hide the check-in/check-out controls.
`hideguestpicker`	boolean	No	—	Hide the guest picker.
`hideadults`	boolean	No	—	Hide the adults selector.
`hidechildren`	boolean	No	—	Hide the children selector.
`hiderooms`	boolean	No	—	Hide the rooms selector.
`hidemodeswitcher`	boolean	No	—	Hide the accommodation/experience mode switcher.
`hidemainmarker`	boolean	No	—	Hide the main center marker.
`hidestarrating`	boolean	No	—	Hide star ratings.
`hideguestrating`	boolean	No	—	Hide guest ratings.
`hidepriceper`	boolean	No	—	Hide the per-night price label.
`hideroomtypefilter`	boolean	No	—	Hide the room type filter.
`hidenavbuttons`	boolean	No	—	Hide navigation buttons.
`hidebrandlogo`	boolean	No	—	Hide the Stay22 brand logo.
`hidefooter`	boolean	No	—	Hide the footer.
`hidenavimage`	boolean	No	—	Hide the navigation image.
`hideallezbutton`	boolean	No	—	Hide the Allez redirect button.

Localization

Parameter	Type	Required	Default	Description
`currency`	string	No	—	Currency code (e.g. `USD`, `EUR`). Auto-detected by default.
`supportedcurrencies`	string	No	—	Restrict available currencies to this comma-separated list.
`ljs`	string	No	—	Force the widget language. Two-letter code. Options: `en`, `fr`, `de`, `es`, `pt`, `it`, `nl`, `pl`, `zh`, `zh-tw`, `ja`, `cs`, `no`, `tr`, `sv`, `uk`. Auto-detected by default.
`supportedlang`	string	No	—	Restrict available languages to this comma-separated list.
`unitsystem`	string	No	—	Unit system. Options: `metric`, `imperial`.

Full example

<iframe
  src="https://www.stay22.com/embed/gm?aid=<AID>&lat=45.4960&lng=-73.5693&checkin=2026-08-15&checkout=2026-08-17&adults=2&campaign=bell_centre_concert"
  style="width: 100%; height: 380px; border: none;"
  loading="lazy"
></iframe>

Sizing

The iframe is responsive by default. Recommended dimensions:

Width: 100% of the container
Height: 380px is a good default; adjust to fit your layout
Border: none for a clean look

iframe {
  width: 100%;
  height: 380px;
  border: none;
  border-radius: 8px; /* optional */
}