Mango support KML files containing Google Earth placemarks (points), paths (lines) or polygons.

My Data is in KMZ format – how do I convert it to KML?

A KMZ file is compressed zip archive containing KML files with a .kmz file extension. The contents of a .kmz file are a single root KML document (notionally “doc.kml”), and optionally, any overlays, images, links, icons, or 3D models. The KMZ archive format is not supported in Mango.

To convert KMZ to KML try these methods:

  • Open the KMZ in Google Earth, and then export it using File / Save Place As.. and choose KML from the file types.
  • Alternatively, simply use your desktop unzip program to unzip the KMZ and upload the KML file to Mango.
    If your system doesn’t recognize the KMZ as an archive, then you can either change the file extension from .kmz to .zip or you can open the file from within a zip program, rather than right clicking the file in your file browser to begin the extraction.


If your KML contains more than one feature type (placemarks, paths and polygons) then only the first feature type will be loaded into Mango.
Mango does not support KML containing HTML, embedded images, 3D features, links, linked images, or folders.

KML Upload Errors

You may experience a KML upload error if your file contains Google Earth “Image Overlays” – usually a link to an image server or a static image, or “Models”. If your data contains these, you will experience upload errors. Remove all from your KML before uploading.

Common Problems:

  1. KML file containing multiple folders may not upload as per the example below.
    You need to restructure the data to have one folder like this:
  2. If your KML file contains multiple shape types (point, line, polygon) it will fail to upload. These need to be separated and saved as separate KML files.
  3. Check that your file does not contain an “image overlay” as per the example below. We do not support Google Earth image overlays.

Need more help with this?
✉ Email the Mango support team

Was this helpful?

Yes No
You indicated this topic was not helpful to you ...
Could you please leave a comment telling us why? Thank you!
Thanks for your feedback.