Skip to main content

Set geographic location

Requirements
  • You have installed the Katalon TestCloud Keywords plugin to automatically load all TestCloud keywords into your project without having to manually define them. If you have not, visit Katalon Store: Katalon TestCloud keywords.
  • This keyword is applicable for desktop browser testing (Windows, macOS), mobile browser testing, and mobile native app testing.

TestCloud supports setting geographic location for mobile and web testing. In some test scenarios, you may want to dynamically set geographic location (or geolocation) to:

  • Ensure the website and mobile app display correctly when accessed from different geolocations.
  • Verify that localization features such as language translation, currency change, and time zone changes reflect accurately according to different locations.
  • Confirm that blocked or restricted content like images, content, or videos are blocked as intended from different locations.

You can simulate geolocation at the start of testing sessions using the desired capability geoLocation.

  1. In Katalon Studio, click the Profile drop-down and select Reload Plugins to make sure the plugin is installed.
Reload plugins
  1. Go to Project Settings > Desired Capabilities > TestCloud.
  2. In the TestCloud table, add a katalon:options property, set Type as Dictionary, then click the ....
TestCloud desired capabilities settings
  1. In the Dictionary Property Builder dialog, add the String property geoLocation=<country-code>. Then, click OK.
Dictionary Property Builder dialog
  1. Add the setMobileGeoLocation keyword to your test case as needed.

    Add keyword to test case
  2. Configure your TestCloud environment and run the test.

info
  • Geolocation testing cannot be performed together with private/local testing using TestCloud Tunnel or by whitelisting TestCloud IPs.
  • If you need to test both geolocation and private/local environments, we recommend leveraging parallel testing - run two separate tests simultaneously: one for geolocation and another for private/local testing.

Supported IP Geolocations

The following is the list of supported IP Geolocations.

CountryCode
Adelaide (Australia)AU/AL
AlbaniaAL
Alberta (Canada)CA/AB
Albuquerque, New Mexico (US)US/ABQ
AndorraAD
Andhra Pradesh (India)IN/AP
Ankara (Turkey)TR/ANK
ArgentinaAR
ArmeniaAM
Ashburn, Virginia (US)US/AB
Atlanta, Georgia (US)US/AT
Auckland (New Zealand)NZ/AU
AustraliaAU
AustriaAT
AzerbaijanAZ
BahrainBH
BangladeshBD
Barcelona (Spain)ES/BCN
BelarusBY
BelgiumBE
BerlinV2
Berkeley Springs, WV (US)US/BS
Billings, Montana (US)US/BL
Boca Raton, Florida (US)US/BR
Bolivia (La Paz)BO/LPZ
Bosnia and HerzegovinaBA
Boston, Massachusetts (US)US/BO
BrazilBR
British Colombia (Canada)CA/BC
Brunswick, Maine (US)US/BWK
Buffalo, New York (US)US/BU
BulgariaBG
CambodiaKH
CanadaCA
Canberra (Australia)AU/CN
Charlotte, NC (US)US/CH
Cheyenne, Wyoming (US)US/CY
ChileCL
ChinaCN
Chicago, Illinois (US)US/CHI
ColombiaCO
Columbus, Ohio (US)US/CO
Connecticut (US)US/CN
Costa RicaCR
Cromwell, Connecticut (US)US/CM
CuracaoCW
CyprusCY
Czech RepublicCZ
Dallas, Texas (US)US/DL
Dallas-Ft. Worth, Texas (US)US/DFW
DenmarkDK
Denver, Colorado (US)Y6
Des Moines, Iowa (US)US/DM
Detroit, Michigan (US)US/DET
Dominican RepublicDO
Dublin (Ireland)IE/DU
EcuadorEC
EgyptEG
El SalvadorSV
EstoniaEE
FinlandFI
FranceFR
GeorgiaGE
GermanyDE
GreeceGR
GuatemalaGT
Harrisburg, Pennsylvania (US)US/HB
Hollywood, Florida (US)US/HW
HondurasHN
Hong KongHK
Honolulu, HIU3
Houston, Texas (US)US/HO
HungaryHU
IcelandIS
IndiaIN
IndonesiaID
Indianapolis, Indiana (US)US/IN
Iowa (US)US/IW
IrelandIE
Isle of ManIM
IsraelIL
ItalyIT
JamaicaJM
JapanJP
Jersey City, New Jersey (US)US/JC
JordanJO
Kansas City, Missouri (US)US/KC
KazakhstanKZ
KenyaKE
KoreaKR
KuwaitKW
KyrgyzstanKG
La Paz (Bolivia)BO/LPZ
Las Vegas, Nevada (US)US/LV
LatviaLV
LebanonLB
Lincoln, Nebraska (US)US/LC
LithuaniaLT
LondonW8
Los Angeles, California (US)US/LA
LuxembourgLU
Madrid (Spain)ES/MAD
Manhattan, New York (US)US/MHT
Maryland (US)US/ML
MaltaMT
Melbourne (Australia)AU/ML
Memphis, Tennessee (US)W4
MexicoMX
Miami, Florida (US)US/MI
Milan (Italy)IT/MIL
Minneapolis, Minnesota (US)US/MIN
Minnesota (US)US/MN
MoldovaMD
MongoliaMN
Montana (US)US/MT
Monticello, Illinois (US)US/MO
MoroccoMA
Mumbai (India)IN/MU
Munich (Germany)DE/MUN
Nairobi (Kenya)KE/NAI
Nebraska (US)US/NB
New Hamisphere (US)US/NH
New Jersey, New JerseyX4
New Orleans, Louisiana (US)US/NO
New York City, New York (US)US/NYC
New York City, New York (US)Z0
New ZealandNZ
NicaraguaNI
NigeriaNG
NorwayNO
Oklahoma City, Oklahoma (US)US/OKC
OmanOM
Ontario (Canada)CA/ON
Orlando, Florida (US)US/ORL
PakistanPK
PanamaPA
ParaguayPY
Paris (France)FR/PA
Perth (Australia)AU/PT
PeruPE
PhilippinesPH
Phoenix, Arizona (US)US/PHX
Pittsburgh, Pennsylvania (US)US/PIT
PolandPL
PortugalPT
Puerto RicoPR
QatarQA
Raleigh, North Carolina (US)US/RA
Reston, Virginia (US)US/RT
Reykjavik (Iceland)IS/REK
Richmond, Virginia (US)US/RM
RomaniaRO
Russian FederationRU
Sacramento, California (US)US/SAC
Saint Petersburg (Russia)RU/SP
Salem, New Hampshire (US)US/SLE
Salem, NHU5
Salt Lake City, Utah (US)US/SLC
San Diego, California (US)US/SD
San Francisco, California (US)US/SF
San Jose, California (US)US/SJ
Santa Clara, California (US)US/SC
Saudi ArabiaSA
SerbiaRS
Seattle, Washington (US)US/SEA
SingaporeSG
Sioux Falls, South Dakota (US)US/SFL
SlovakiaSK
SloveniaSI
South AfricaZA
South Bend, Indiana (US)US/SB
SpainES
Sterling, Virginia (US)US/ST
St Louis, Missouri (US)US/STL
SwedenSE
SwitzerlandCH
Sydney (Australia)AU/SY
TaiwanTW
Tampa, Florida (US)US/TPA
TanzaniaTZ
ThailandTH
TunisiaTN
TurkeyTR
TurkmenistanTM
UkraineUA
United Arab EmiratesAE
United KingdomGB
United StatesUS
UruguayUY
UzbekistanUZ
VenezuelaVE
VietnamVN
WashingtonZ6
Washington (Herndon), VirginiaUS/WAV
Wilmington, DEU4
Wilmington, Delaware (US)US/WILM
Was this page helpful?