FILE FORMAT GUIDE

KML File: Open Geographic Data and Check Resources

A KML file describes geographic features for display in an Earth browser. Open it in a compatible mapping application to see placemarks, paths or overlays. A text editor can show the XML but does not render the map.

Quick facts

Extension
.kml
Format
Keyhole Markup Language
Category
data
MIME type
application/vnd.google-earth.kml+xml
Standard / developer
Open Geospatial Consortium
Open with
Google Earth local KML editor

What is KML?

KML is an OGC-standard XML grammar for showing geographic data. A KML document can reference supporting images or other resources; a KMZ archive is a separate packaging option for KML and related files.

How to open KML

Check whether you are opening a local file or importing into a cloud project. Resource and network links may still reference external content.

Google Earth local KML editorWeb; Google Earth service

Choose Open local KML editor, then Open KML from device. Use the separate cloud-project import workflow only when that is intended.

Common uses and compatibility

  • Describe placemarks, paths, polygons or overlays in an Earth browser.
  • Exchange geographic display data with supporting resources.

Things to check

  • Network links and resource references can load external content when a mapping application renders the document.
  • Local KML editing and importing into a cloud project are different Google Earth workflows.

Technical details

Signature
No registered magic number
Encoding
Unknown
Container
XML-based KML document for geographic display features
Compression
Not inherent to the format

OGC KML 2.3

Open a local KML in Google Earth

For the desktop web workflow documented by Google, open Google Earth and choose its local KML editor. This is distinct from importing data into a cloud-based map project.

  1. On the home screen, choose Open local KML editor.
  2. Choose Open KML from device and select the file.
  3. Review the features and resource references; use the appropriate save or project workflow for your intended result.

Sources: Open local KML files or import data — Google Earth

Why is text visible instead of a map?

KML uses XML tags and attributes. A text editor displays that source, while an Earth browser interprets the geographic features. Do not change coordinate or XML content only to make a thumbnail appear.

Sources: KML tutorial — Google

Why do images or linked features fail to appear?

A KML can refer to additional resources. Check that those resources are available in their expected locations, or obtain a complete KMZ package when that is how the sender intended to distribute the data.

Sources: OGC KML 2.3 · KML tutorial — Google

KML, KMZ and ZIP are different layers

A KMZ can package a main KML with images or other supporting files. A plain KML remains XML; renaming it to KMZ or ZIP does not create the required archive structure.

Sources: OGC KML 2.3

Related formats

  • KML Zipped Archive

    KMZ wraps KML and optional resources in ZIP packaging; it is not a synonym for an uncompressed KML document.

  • Extensible Markup Language

    KML is an XML grammar for geographic display data, not an arbitrary XML document.

Sources & review

Sources reviewed 2026-11-15.