Troubleshooting Shapefile Uploads

Project Leader has very specific definitions for shapefiles that can be accommodated in our upload tools. Due to recent changes with ESRI products and defaults, there has been an increase in user errors when uploading sampling units from a shapefile. This guide details the requirements Project Leader adheres to for shapefile formats. If you are getting an error trying to load a shapefile, please use this guide as a reference.

Shapefile Requirements Guide

This guide ensures your shapefiles are compatible with our system. Please follow these requirements to avoid upload issues.

📁 File Structure Requirements

Required Files

Your shapefile must be packaged as a ZIP file containing these essential components:

• .shp - The main file containing geometry data

• .shx - Index file (required for proper file access)

• .dbf - Attribute table containing feature properties

• .prj - Projection file (critical for coordinate system information)

Optional but Recommended Files

• .cpg - Character encoding information

• .xml - Metadata file

⚠️ Important ZIP Guidelines

• Place all shapefile components directly in the root of the ZIP file (not in subfolders)

• All files must share the same base name (e.g., roads.shp, roads.shx, roads.dbf, roads.prj)

• Compress using standard ZIP format (not RAR, 7Z, or other formats)

🌍 Coordinate System Requirements

Required Projection

Your shapefile must use:

• Coordinate System: WGS84 (World Geodetic System 1984)

• EPSG Code: 4326

• Format: Decimal degrees (latitude/longitude)

How to Verify Your Projection

Check your .prj file contents. It should contain text similar to:

Common Projection Issues

❌ Not Supported:

• UTM projections (e.g., EPSG:32633)

• State Plane coordinates

• Local coordinate systems

• Web Mercator (EPSG:3857)

✅ Correct Format:

• Coordinates like: -122.4194, 37.7749 (San Francisco)

• Latitude range: -90 to +90

• Longitude range: -180 to +180

📐 Geometry Type Requirements

Supported Geometry Types

✅ 2D Geometries Only:

• Point - Standard 2D points

• LineString - 2D lines and polylines

• Polygon - 2D polygons and multipolygons

❌ Unsupported Geometry Types

We do not support 3D or measured geometries:

• PointZ (3D points with elevation)

• PointM (points with measure values)

• LineStringZ (3D lines)

• LineStringM (lines with measures)

• PolygonZ (3D polygons)

• PolygonM (polygons with measures)

🔍 How to Validate Your Shapefile

Online Validation Tools

1. QGIS (Desktop Software)

• Open QGIS (free download)

• Drag your ZIP file into QGIS

• Check the layer properties for coordinate system information

Quick Validation Checklist

• All required files (.shp, .shx, .dbf, .prj) are present

• Files are in a ZIP archive (not individual files)

• Coordinate system is WGS84/EPSG:4326

• Coordinates are in decimal degrees

• No 3D (Z) or measured (M) geometry types

• File opens correctly in validation tool

🛠️ How to Fix Common Issues

Missing Projection File

If your .prj file is missing or incorrect:

1. Open your shapefile in QGIS

2. Right-click layer → Properties → Source → CRS

3. Set to "WGS 84" (EPSG:4326)

4. Export the layer to create a new shapefile with correct projection

Wrong Coordinate System

To reproject your data:

1. Load shapefile in QGIS

2. Right-click layer → Export → Save Features As

3. Set CRS to "WGS 84 - EPSG:4326"

4. Save as new shapefile

3D Geometry Types

You can either convert the shapefile from 3D to 2D, or you can keep the original file in 3D and export it to a 2D format.

To convert 3D to 2D geometries using QGIS:

1. Open in QGIS

2. Use Processing → Toolbox → "Force 2D"

3. Or use Vector → Geometry Tools → "Force 2D"

4. Export the result

To convert 3D to 2D geometries using ESRI, see the ESRI knowledge base: https://support.esri.com/en-us/knowledge-base/how-to-convert-3d-shapefiles-to-2d-shapefiles-000008433

To export 3D to 2D geometry using ESRI:

1. Under “Export Features, click on the “Environments” tab
   
   

   Open

   

2. Scroll all the way down to the bottom where it says "M values" and "Z values".  Under each "Output has M values" or "Output has Z values" click the dropdown button (these default to "Same as input") and change them to "Disabled."  Then click OK to export the feature like normal.
   
   

   Open

   

📋 Pre-Upload Checklist

Before uploading your shapefile, verify:

File Structure

• Shapefile is packaged as a ZIP file

• ZIP contains .shp, .shx, .dbf, and .prj files

• All files have the same base name

• Files are in ZIP root (not in subfolders)

Coordinate System

• Projection is WGS84 (EPSG:4326)

• Coordinates are in decimal degrees

• Latitude values between -90 and +90

• Longitude values between -180 and +180

Geometry Types

• Only 2D geometries (Point, LineString, Polygon)

• No PointZ, PointM, or other 3D/measured types

• File loads successfully in validation tool

💡 Pro Tips

1. Keep originals: Save a backup of your original data before making changes

2. Use QGIS: It's free and handles most projection and geometry conversion tasks

3. Check attribute data: Ensure your .dbf file contains the expected attribute columns

For additional support, contact our technical team with your specific error message and we'll help troubleshoot your shapefile.