Unable to load KML: Internal kml parser error

Last Published: April 25, 2020

Error Message

When adding a KML file using the 'From my computer' option to Portal for ArcGIS, the following error message is returned:

Unable to load KML: Internal kml parser error.


The error occurs because the script in the KML file is not encoded using UTF-8.

Solution or Workaround

Follow the steps below to encode the script using UTF-8.

  1. Open the KML file in a text editor such as Notepad ++.
  2. Click the Encoding tab and select Convert to UTF-8.

    Encoding tab and UTF- 8 option
  3. Save the file and add to Portal for ArcGIS. For more detailed steps, refer to Portal for ArcGIS Web Help: Add layers from the web .

Article ID:000018602

  • Portal for ArcGIS

Receive notifications and find solutions for new or common issues

Get summarized answers and video solutions from our new AI chatbot.

Download the Esri Support App

Related Information

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options