Basic and Location Widgets (Flights)

 

Our Basic Widget provides a clean and simple tracked referral to flight search on Skyscanner or a White Label. And the Location Widget provides users a pre-filled destination for flight search on our site, leaving them with less details to select when referred to Skyscanner and allowing them to perform a search immediately on a White Label.

Associate ID and Tracking

If you have a direct partnership with Skyscanner, you will have to add your associate ID to the HTML snippet to ensure your exits are tracked. To do so, add data-associate-id="ABC_DEF_12345_56789" to the HTML snippet as shown below.

If you do not know your associate ID, you can obtain it from your account manager.

Scripted Location Widgets

"I have hundreds of content pages, do I have to create a widget manually for each location?"

We've got you covered! With scripted location widgets you can write just a little bit of JavaScript and have widgets automatically set their location on each. For details, check out the documentation ("location" parameter).

Widgets for White Labels

"I already have a White Label, can I use widgets to send traffic to it?"

Of course! Our widgets have been designed to work with our White Labels from the start and include features such as automatic styling to make your life easier. To use a widget with your White Label, check out the documentation ("whitelabeldomain" parameter).

Widget Options

You can customize your widgets with localization, colours, text and more - see below for details on how to set these options.

Skyscanner Widget
skyscannerWidget

data-skyscanner-widget="BasicWidget"

Defines the widget type.

Show details

One of BasicWidget, LocationWidget

Associate ID
associateId

data-associate-id="ABC_DEF_12345_56789"

Allows for tracking of widget exits.

You can obtain your associate ID from your account manager or by contacting us.

Affiliate ID string

"WIG_WBT_01426_00001"

Locale
locale

data-locale="ru-RU"

Sets widget language.

You can use one of
"bg-BG", "ca-ES", "cs-CZ", "da-DK", "de-AT", "de-CH", "de-DE", "el-GR", "en-GB", "en-GG", "en-US", "es-ES", "es-MX", "fi-FI", "fr-BE", "fr-CH", "fr-FR", "hr-HR", "hu-HU", "id-ID", "it-CH", "it-IT", "ja-JP", "ko-KR", "ms-MY", "nb-NO", "nl-BE", "nl-NL", "pl-PL", "pt-BR", "pt-PT", "ro-RO", "ru-RU", "sk-SK", "sv-SE", "th-TH", "tl-PH", "tr-TR", "uk-UA", "vi-VN", "zh-CN", "zh-HK", "zh-SG", "zh-TW"

(Note: the "locale" value is case-sensitive)

Four letter locale code

"en-GB"

Market
market

data-market="AU"

Sets the target Skyscanner domain.

(Note: this will impact flights shown based on local market restrictions and inventory)

Two letter country code

"GB"

Currency
currency

data-currency="USD"

Sets the currency to display upon redirect to Skyscanner search results

Three letter currency code

"GBP"

Location
location

data-location="'Edinburgh'"

Sets a fixed destination (to)
(note: that single quotes inside of the double quotes are required)

Show details

Free text (Location name in single quotes)

Location ID
locationId

data-location-id="'EDI'"

Sets a fixed destination (to)
(note: that single quotes inside of the double quotes are required)

Three letter geocode in single quotes

Origin IATA Code
originIataCode

data-origin-iata-code="'LAX'"

Sets a fixed origin aiport (from)

IATA code

Destination IATA Code
destinationIataCode

data-destination-iata-code="'LAX'"

Sets a fixed destination airport (to)

Show details

IATA code

Origin Geo Lookup
originGeoLookup

data-origin-geo-lookup="true"

Uses GEO-IP to infer an origin (from)

Show details

true / false

false

Destination Geo Lookup
destinationGeoLookup

data-destination-geo-lookup="true"

Uses GEO-IP to infer an destination (to)

true / false

false

Origin Coords
originCoords

data-origin-coords="55.944339,-3.1952956"

Sets origin nearest to given <longitude>,<latitude>

Comma separated pair of float numbers

Destination Coords
destinationCoords

data-destination-coords="55.944339,-3.1952956"

Sets destination nearest to given <longitude>,<latitude>

Show details

Comma separated pair of float numbers

Origin Phrase
originPhrase

data-origin-phrase="'Take off from Florida'"

Finds an origin name from the given string

Free text

Destination Phrase
destinationPhrase

data-destination-phrase="'Best holiday ideas in Turkey'"

Finds a destination name from the given string

Show details

Free text

Whitelabel Domain
whitelabeldomain

data-whitelabeldomain="whitelabeldemo.skyscanner.net"

Redirects to partner's WhiteLabel page

Show details

WhiteLabel's CNAME

Target
target

data-target="_self"

Opens the Skyscanner search results in the same window (_self) or new window (_blank)

One of "_self", "_blank"

"_blank"

Title
title

data-title="Let's go to {location} right now!"

Customises widget text

Show details

Free text
(template string with "{location}" placeholder)

Search for flights [to {location}]

Colour
colour

data-colour="solar"

Changes background colour of the widget.

Show details

Preset color name or hex code

"glen"

Arrow Icon
arrowIcon

data-arrow-icon="true"

Shows arrow icon instead of plane icon in the search button

Show details

true / false

false

Params
params

data-params="colour:glen;location:Edinburgh;locationId:EDI"

Semicolon separated list of extra widget parameters

Any
(URL encoded if it has special symbols)

Widget Builder

Here you can play around with parameters of widgets and construct Basic or Location Widget of your preference using the side panel on the left. There are many of them, make sure you find the right one for you!

By using Skyscanner's Widgets you agree to our Terms and Conditions.