Itsy Docs
Data

Locations

Manage the geographic places used across trips, products, and itineraries.

Locations are the geographic places your business operates in and around. Every destination, pickup point, airport, city, or region you reference in trips and products is defined here. Locations serve as a shared directory so you define a place once and reuse it everywhere.

How It Works

You create a location by choosing its type (country, city, airport, etc.), entering a name, and optionally filling in address details, coordinates, and transport codes. Locations can be active or inactive — only active locations appear when building trips and products.

Key Concepts

Location Types

Each location has a type that describes what kind of place it is:

TypeDescription
CountryA nation or sovereign state
RegionA geographic area within a country (e.g., South Iceland, Tuscany)
CityA city or town
DistrictA neighborhood or subdivision within a city
PlaceA specific point of interest, landmark, or venue
AddressA precise street address
CustomAny location that doesn't fit the other types

Location Details

Each location can include:

FieldDescription
NameThe internal name
Display NameThe name shown to customers (if different from the internal name)
DescriptionAdditional details about the location
CoordinatesLatitude, longitude, and altitude
AddressFull address fields (street, city, postal code, state, country)
TimezoneThe location's timezone, used for scheduling

Transport Codes

For locations that represent airports, train stations, or ports, you can store standard transport codes:

CodeDescription
IATA Code3-letter airport code (e.g., KEF, LHR)
ICAO Code4-letter aviation code (e.g., BIKF, EGLL)
Station CodeRailway station identifier
Port CodeMaritime port identifier

These codes are used by integrations (such as Amadeus) to match external booking data to your locations.

External Identifiers

You can also link locations to external mapping services:

  • Google Place ID — Links to a Google Maps location
  • OpenStreetMap ID — Links to an OSM node or way

Custom Attributes

Locations support a flexible attributes field for storing additional data specific to your business needs.

Common Tasks

Creating a Location

  1. Navigate to Data > Locations
  2. Click Add
  3. Choose the location type
  4. Enter the name and any display name
  5. Fill in address and coordinate details as needed
  6. Add transport codes if applicable (IATA, ICAO, station, port)
  7. Set the timezone
  8. Mark as active
  9. Click Save

Organizing Locations

  • Use location types consistently to make filtering easier
  • Set display names when the customer-facing name differs from your internal name
  • Add transport codes for any location used in flight or transportation products

Deactivating a Location

Set a location to inactive when you no longer operate there. Inactive locations remain in the system for historical records but won't appear in dropdown menus when building new trips or products.

How It Connects

  • Inventory — Products reference locations for pickup points, airports, accommodations, and activity venues.
  • Trips — Trips use locations to define itinerary stops and destinations.

On this page