How to import a KMZ into DJI Fly (iPhone and RC 2)

DJI Fly can't import or export a waypoint file. The way in is a swap: replace a placeholder mission's KMZ with yours, under exactly the same name.

By Sander Helgesen · Last checked

In short

  • DJI Fly has no import button. Make a two-point placeholder mission, close DJI Fly, and replace its KMZ with yours under exactly the same name.
  • iPhone with an RC-N2 or RC-N3: Files › On My iPhone › DJI Fly › wayline_mission/<UUID>/<UUID>.kmz.
  • DJI RC or RC 2: Android/data/dji.go.v5/files/waypoint/<UUID>/<UUID>.kmz on the controller, reached from a computer over USB.
  • The file is DJI WPML, not a Google Earth KMZ, and it takes exactly the placeholder's file name.
  • At most 200 waypoints per mission. A bigger job is flown as several missions.

Why DJI Fly needs a placeholder

DJI Fly lists only missions it already knows, so a new file shows up only in place of one of them.

What the file must be

  • A DJI WPML KMZ: a zip with wpmz/template.kml and wpmz/waylines.wpml inside, as in DJI's WPML documentation. A KMZ from Google Earth is a different format.
  • Made for the drone model you fly, the one the placeholder was made with.
  • No more than 200 waypoints. DJI Fly refuses more.
  • Named exactly like the file it replaces, <UUID>.kmz, in the same <UUID> folder.

On an iPhone (RC-N2 or RC-N3)

With a controller without a screen, DJI Fly runs on your phone and keeps the missions there.

  1. Make a placeholder mission

    In DJI Fly, make a waypoint mission with two points, save it and give it a name you'll recognise. Use the drone model you'll fly the real mission with.

  2. Close DJI Fly completely

    Swipe it away in the app switcher. If it runs during the swap, it can save its own copy over yours.

  3. Get your mission as a DJI Fly KMZ

    Export the mission for DJI Fly from your planner and save it in Files.

  4. Find the placeholder's folder

    Open Files › On My iPhone › DJI Fly › wayline_mission. Each mission has a folder with a long random name (a UUID), holding one file with the same name: <UUID>/<UUID>.kmz. Sort by date: the newest folder is usually your placeholder.

  5. Replace the file, keeping its name

    Rename your KMZ to the placeholder's exact file name, move it into that folder and choose Replace.

  6. Open DJI Fly and check the route

    Open the mission in DJI Fly and check every waypoint before you fly. The thumbnail shows the placeholder's route until you open it, and the name in the list stays the placeholder's: it comes from DJI Fly's database, not the file.

On a DJI RC or RC 2 (screen controller)

DJI Fly keeps the missions in the controller's Android storage, reached from a computer over USB. In Chrome on an Android phone or a Mac, Other formats › For DJI RC / RC 2 › Install over USB (beta) on the mission page does steps 2 to 4 for you.

  1. Make a placeholder mission on the controller

    Open DJI Fly on the controller, make a short waypoint mission with two points, save it and close DJI Fly.

  2. Connect the controller to a computer

    Use a USB-C cable. On a Mac, open the controller with Android File Transfer or OpenMTP; on Windows, use File Explorer, which works best with the RC 2.

  3. Open the waypoint folder

    Go to Android/data/dji.go.v5/files/waypoint/ and open the newest <UUID> folder. Copy its name.

  4. Replace the KMZ

    Name your DJI Fly KMZ <UUID>.kmz, exactly like the folder, and copy it in over the old file. The controller keeps no mission database, so that is enough.

  5. Disconnect and check the route

    Unplug the controller, open DJI Fly, open the mission and check every waypoint before you fly.

Which drones

This guide and Skyplanr's DJI Fly missions are for the DJI Mini 4 Pro, DJI Mini 5 Pro, DJI Air 3, DJI Air 3S, DJI Mavic 3 Pro and DJI Mavic 4 Pro. Enterprise drones flown with DJI Pilot 2 get a Pilot 2 KMZ instead, and other drones a Litchi CSV, QGroundControl plan, KML or GeoJSON. DJI waypoints has the drones, the apps and the limits side by side.

More than 200 waypoints, or more than one battery

DJI Fly doesn't resume a mission after a battery swap, so a bigger job is flown as several flights from the same takeoff, each its own KMZ of at most 200 waypoints. The mapping guide shows how to split a grid, and photo processing turns the photos into an orthophoto.

  • Make one placeholder mission per flight, and close DJI Fly.
  • Replace each placeholder's KMZ with one flight and note which UUID holds which.
  • Fly them in order from the same takeoff, swapping the battery between flights.

Before you fly

  • Heights in the file count from the takeoff point. Take off from the planned spot, or the whole route moves up or down with the ground.
  • DJI Fly has no terrain follow on waypoint missions, so a slope under the route has to be in the file's heights.
  • Set DJI Fly's Max Altitude at least as high as the highest waypoint and the return-to-home height. A mission with a waypoint above it fails.
  • Open the mission in DJI Fly to check it, but do not edit, save or cloud-sync it on the controller. If you did, install the file again.

When it doesn't work

  • The old route still shows: DJI Fly was running during the swap. Close it completely, replace the file again, then open DJI Fly.
  • The mission goes back to the old route or shows up twice: DJI Fly 1.17 and later can sync waypoint missions to your DJI account. Turn off sync for that mission (or Sync Flight Data in DJI Fly's settings), then replace the file again.
  • Files asks whether to keep both: choose Replace. A kept copy gets another name, and DJI Fly ignores it.
  • Android/data doesn't show up on the computer: newer controller firmware can hide it over USB. Litchi Utilities suggests turning on USB file transfer on the controller; desktop tools such as Litchi Hub Bridge and MavenBridge write the mission over USB themselves.
  • DJI Fly won't start the mission: check that it was made for this drone model, has no more than 200 waypoints, and that no waypoint is above Max Altitude.

Where Skyplanr fits in

Describe the job and Skyplanr writes the DJI Fly KMZ, checks it with 106 rule-based checks before you can download it, and tells you the Max Altitude to set. A job over 200 waypoints or one battery comes as one file per flight. For a DJI RC or RC 2, paste the placeholder's folder name and the download is already named <UUID>.kmz. Exports are free on every plan; see pricing.

See the technology

Questions

Can DJI Fly import a KMZ file?

No. You get a mission in by replacing a placeholder mission's file, keeping exactly the same file name.

Where does DJI Fly store waypoint files?

On an iPhone, in Files › On My iPhone › DJI Fly › wayline_mission: each mission is a folder named with a UUID, holding <UUID>.kmz, next to mission_db (DJI Fly's mission list) and map_preview (the thumbnails), which you leave alone. On a DJI RC or RC 2, on the controller: Android/data/dji.go.v5/files/waypoint/<UUID>/<UUID>.kmz in its Android storage, reached from a computer over a USB-C cable.

Why doesn't my KMZ show up in DJI Fly?

DJI Fly lists only missions it already knows, so the file must replace a placeholder's under exactly its name. If the old route still shows, DJI Fly was running during the swap: close it and replace the file again. A copy Files kept under another name is ignored. And the file must be a DJI WPML KMZ for your drone model, not a Google Earth KMZ.

Can I use a KMZ from Google Earth?

Not as it is. DJI Fly reads DJI WPML, a KMZ holding wpmz/template.kml and wpmz/waylines.wpml, so a Google Earth route has to be turned into a DJI WPML mission first.

How many waypoints can a DJI Fly mission have?

200. A bigger job is split into several missions, each with its own placeholder.

Which drones does this work with?

Skyplanr's DJI Fly missions are for the DJI Mini 4 Pro, DJI Mini 5 Pro, DJI Air 3, DJI Air 3S, DJI Mavic 3 Pro and DJI Mavic 4 Pro. Enterprise drones flown with DJI Pilot 2 get a Pilot 2 KMZ; other drones get Litchi CSV, QGroundControl, KML or GeoJSON.

Sources

Skyplanr is not affiliated with the third-party guides linked here.

  1. DJI Developer: DJI WPML overview (the KMZ format DJI Fly reads) (developer.dji.com)
  2. DJI Developer: DJI WPML template.kml reference (developer.dji.com)
  3. Litchi Utilities: DJI Fly waypoint KMZ import and export (iPhone and DJI RC paths) (litchiutilities.com)
  4. WaypointMap: tutorial (iPhone and DJI RC 2 steps) (waypointmap.com)
  5. Litchi forum: DJI RC controller support using Hub Bridge (forum.flylitchi.com)
  6. MavenBridge: sending KMZ waypoint missions to DJI Fly over USB (mavenpilot.com)

This guide describes how DJI Fly behaved when it was last checked; DJI can change the app at any time. It is advice, not a permission: you are the pilot in command, and the site, the geo-zones and the rules are yours to check before takeoff.

Let Skyplanr write the file.

Describe the job, and Skyplanr plans the waypoint mission, checks it and gives you the KMZ for DJI Fly.

Plan a mission free