> For the complete documentation index, see [llms.txt](https://help.felt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.felt.com/upload-anything/troubleshooting.md). # Troubleshooting ## ESRI Shapefiles Shapefiles are a [multi-file format](https://en.wikipedia.org/wiki/Shapefile#Overview), with each file containing some specific data. Three file parts are mandatory (`.shp`, `.shx` and `.dbf`) and, without any of them, your upload will not be successful. A fourth component (`.prj`) is very common, and used to determine what [Spatial Reference System](https://en.wikipedia.org/wiki/Spatial_reference_system) should be used to interpret the coordinates in your data. If this file is not present, Felt will assume the coordinates are in latitude/longitude (represented by the EPSG code `4326`). ## Spreadsheets See the [Spreadsheets](/upload-anything/spreadsheets.md) page for general information on tabular file formats like CSV or Excel. ### Point coordinates * Coordinates must be in latitude and longitude. Other coordinate systems, such as UTM, are not supported. * Coordinates must be in numeric format, such as 40.7128 or -74.006. Felt cannot parse coordinates with text characters, such as **40° 43' 50.1960'' N** or **74.0060° W**. * Coordinates must be in two separate fields. ### Geocoding * By default, Felt will geocode address data for up to 10,000 addresses per upload. If you need a higher limit, [contact sales](https://felt.com/sales) to upgrade to our [Enterprise plan](https://felt.com/pricing). * Context is important. Make sure either your `address` field contains all the necessary information (city, state, country, etc) *or* you have several fields with that information. * See the [Spreadsheets](/upload-anything/spreadsheets.md) page for general information on how geocoding works. ### Geomatching See the [Spreadsheets](/upload-anything/spreadsheets.md) page for general information on how Geomatching works. #### Matching threshold Geomatching checks columns in your data for values that match codes or names in our available regions. If a column does not contain a majority of values that match, it will be discarded. #### Duplicate & unique values Geomatching works best with columns that have unique values. Otherwise, you might end up with the same polygon for California many times, superimposed. To avoid that, the Geomatching process makes sure the amount of duplicate values (all values that are repeated at least two times) is under a certain threshold. #### US FIPS codes Make sure your US FIPS codes (states, counties, CBSAs and census tracts) aren’t missing leading zeroes. FIPS codes always have a fixed number of digits per boundary type: 2 for states, 5 for counties, 11 for census tracts, etc. #### US ZIP codes Similarly, ZIP codes should always have 5 digits, so watch out for missing leading zeroes. Also, Felt doesn’t currently understand ZIP+4 codes, so remove the extra suffix if present. ## AutoCAD drawings #### My drawing is in the wrong place CAD drawings (`.dwg`, `.dxf`) only land at their true location when the drawing has a standard, earth-based coordinate system assigned in AutoCAD, or when its geometry is already in geographic coordinates. See the [AutoCAD section](/upload-anything/files.md#autocad) of the Files page for the full requirements. #### My drawing is missing objects Entities that depend on proprietary object types from AutoCAD vertical products (such as Civil 3D surfaces, corridors, or alignments) may be skipped when Felt processes a drawing. Explode those objects into plain AutoCAD geometry before saving the drawing. ## Unsupported file formats #### QGIS metadata files (`.qmd`, `.qgz`, `.qgs`, `.qml`) These files don't actually contain any data, just the metadata that defines a QGIS project (such as the style for layers in the project, references to the actual files, etc). Try uploading the original data files (Shapefiles, GeoPackages, GeoJSON, etc) instead. #### ArcGIS layer files (`.lyr` and `.lyrx`) Similarly, the ArcGIS Layer File format does not contain any actual data, but a *reference* to another file that stores the actual data (usually a Shapefile or Geodatabase). Try uploading the original data files to Felt instead. #### Enhanced Compressed Wavelets (`.ecw`) ECW is a proprietary format developed by Hexagon Geospatial. Try exporting your data as GeoTIFF (`.tif`) instead. ## URL uploads #### Maximum layers per upload Felt will automatically try to parse and upload all layers from an ESRI or OGC service. However, Felt has a maximum of 50 layers per upload (see [Limits](/upload-anything/limits.md)). If the service hosts more than that amount, an error will be returned. For OGC services, users can work around this by specifying which layers to request in the URL query parameters: * *WMTS* and *WFS*: a single layer in the form of `?layer=X` * *WMS*: one or more layers in the form of `?layers=X,Y` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.felt.com/upload-anything/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.