Importing User Waypoints

ForeFlight allows you to import your own collection of user waypoints into the app. This works on both iPad and iPhone. Note: if you import a waypoint with the same name as an existing waypoint, it will be used to overwrite the existing waypoint.

Step 1: Create a data file

Two file formats are supported: CSV and KML. CSV is a simple comma-separated format which can exported from Excel or Google Sheets, or can be created by hand. KML is an XML-based format that can be easily created from programs like Google Earth.

Waypoint names must:

  • Be at least 3 characters long including at least one letter.
  • Be ALL CAPS.
  • Be one word with no spaces.

For example: THE_CABIN is OK, while The Cabin is NOT OK because it includes lower-case and a space.

Additionally, only the first 30-40 characters of the description will be visible, so keeping them short is a good idea. 

Lat/lon values should be in simple numeric decimal-degree format (ie: 34.7 or -81.457, where "negative" Longitude indicates W). No other Lat/Lon formats are supported for bulk importing.

CSV Example (111 bytes)

The CSV file must be organized as follows:

WAYPOINT_NAME,Waypoint description,Lat,Lon

ie: MY_HOUSE,My house,38.1,-79.2 ANOTHER,"",39.22,-81.966 PROPERTY_ALPHA,First house to observe,40.588,-80.1295

If no description is entered, you must indicate the empty description column with "".

ie: ANOTHER,"",39.22,-81.966 

KML Example available: 

user_waypoints.kml (3.0 KB)

IMPORTANT: A CSV file must be named user_waypoints.csv - similarly a KML file must be named user_waypoints.kml. If the files do not match this format and name exactly, ForeFlight Mobile cannot recognize the data in them and they will not show up inside the app.

Step 2: Connect your device to iTunes

Plug your iPad or iPhone into your computer via the Apple USB cord. Start iTunes on your computer, or wait for it to automatically start.

Step 3: Click on your device name in iTunes

Inside iTunes, click on the icon for your iPad, iPhone, or iPod Touch. You will find the device icons at the top of the iTunes screen. Make sure you click on the device that you want to copy procedures to.

If you don't see your device name listed, make sure it is plugged in properly. Try disconnecting the USB cable from both your device and the computer, and then and plugging it in again.

Step 4: Click on the 'Apps' tab for your device

Inside the window for your device, click on the 'Apps' listing on the left. It should show all of the apps you have installed on your device. Scroll to the 'File Sharing' section at the bottom of the page and click on 'ForeFlight'. 

Step 5: Drag your user_waypoints.csv or user_waypoints.kml file into iTunes

On the right, you will see a listing of 'ForeFlight Documents'. If this is the first time you've added procedures to the app, this listing will be empty.

Drag your user_waypoints file and drop it onto the 'ForeFlight Documents' table. While the file is copying over to your device, and you will see a brief 'Sync in Progress' message on your device.

Step 6: Launch ForeFlight

After the copying has completed, launch ForeFlight on your iPad or iPhone. Go to the User Waypoints view inside the app - it is under the More view on the iPad, and Menu > User Waypoints on the iPhone. You will be prompted to imported the new data.

If you choose to import, it will process the file and show a message when complete. The new waypoints will then be listed in the User Waypoints view. The imported file is renamed with "processed" in the name and will still be accessible via the iTunes file sharing view. It can then be deleted as needed.