Rather than being a single file, a Shapefile is made up of a collection of files. To upload your data in Shapefile format you will need the .shp, .dbf, .shx, and .prj files. The names of all files must match.


The maximum size of the .shp component of the Shapefile is 200MB per upload. There is no limit on the number of features that the dataset can contain.

Missing .prj file

If you do not have a .prj file as part of your Shapefile, you will need to create one. If you are using a desktop GIS, you can define your coordinate system as follows:

  • ArcGIS™
    Use the “Define Projection” tool
  • QGIS
    Go to Vector → Data Management Tools → Define Current Projection

Alternatively, you can download a .prj file from This site allows you to find and download specific coordinate systems e.g. “WGS 1984 UTM Zone 33N”.

From the list of results returned in the search, select the appropriate one and the click then click the link “.PRJ File” to download the file.

After you download the .prj file, you will need to rename it to be the same as your shapefile:

parcels_2015 .shp
parcels_2015 .dbf
parcels_2015 .shx
parcels_2015 .prj

Many shapefiles that don’t have a .prj file are using WGS84/Lat Long, so if you are unsure what coordinate system your data is using then you should try using this coordinate system first.

A direct link to WGS84/Lat Long .PRJ is here:

Shapefile Upload Errors

There are a number of reasons why a shapefile upload might fail. The most common errors are detailed below:

Is your shapefile empty?

Mango only supports shapefiles that contain features. To see if the Shapefile you are using contains features, open the Shapefile on a desktop GIS to check.

Does your data have corrupt or null geometry?

Open the shapefile in a desktop GIS and clean or repair your shapes before re-uploading.

  • ArcGIS™
    Run the “Repair Geometry” tool, which can be found in Data Management Tools → Features → Repair Geometry

A basic standalone tool for repairing shapefiles can be downloaded here: It’s fairly basic and may not solve all problems.

  • QGIS
    Run the tool Vector → Geometry Tools → Check Geometry Validity. If errors are reported, these might be causing problems.

A quick fix for geometry errors Vector → Geometry Tools → Simplify Geometry. Use a simplify tolerance of 0.1 if you data is meter based. It’s advisable to save to a new file so you don’t mess up your data.

A more advanced solution is to use a plugin called lwgeom. There are a few steps involved to install and cleanup your file, so it’s best to follow the instructions in this video [] if you are attempting this for the first time.

If you are still having problems with corrupt polygon geometry, consider converting polygons to lines and then back to polygons.

Does your Shapefile have “M” coordinates?

Mango does not support M Coordinates. You will need to remove M coordinates and convert the data to a regular shapefile.

Do you have Blank Data?

Column headers MUST have a name. Check in a desktop GIS if all layers are named.
Date fields CANNOT be empty. We recommend using an arbitrary date such as 01/01/1900.

Are you using invalid characters?

Shapefiles use a dBase file format (.dbf). dBase is a technologically ancient file format devised more than 35 years ago, and as such it doesn’t permit many of the newfangled characters we enjoy in the 21st century.

  • Characters that can be used in column headings
a b c d e f g h i j k l m n o p q r s t u v w y x z 
0 1 2 3 4 5 6 7 8 9 _

Column headers can only contain letters A to Z, numbers, and the underscore. However, field titles MUST BEGIN with a letter.

Valid column title: data_2011
Invalid column title: 2011_data

  • Characters which cannot be used in column headings
` ~ @ # $ % ^ & * ( ) - + =
| < > / \ , . ! ? ' " [ ] { } : ; 

If your column headings use any of these characters, you’re going to have a bad time.

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.