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
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.
- On the home screen, choose Open local KML editor.
- Choose Open KML from device and select the file.
- Review the features and resource references; use the appropriate save or project workflow for your intended result.
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.