Prepare and Upload a Shapefile

Prev Next

Adding geographies to your government's SeeClickFix 311 CRM dashboard allows you to view, organize, and report on requests submitted within smaller subsets of your area, such as neighborhoods, council districts, police precincts, and others.

A Shapefile is a way to store geographic information in a file format. More specifically, a Shapefile is a nontopological format for storing the geometric location and attribute information of geographic features. View more information from Esri.

A Shapefile is a collection of features. For example, if a city has nine council districts then the city can have encoded its districts as nine different features in a shapefile. When this is uploaded to the Geography settings in SeeClickFix 311 CRM, this will create nine new geographies. There is a safety checkbox for more than 10 features because sometimes a city creates a shapefile with thousands of features (one per parcel, or one per road, for example) and that is usually not the desired geography set.

Important Notes

  • Creating a Shapefile takes some expertise in GIS, so we recommend consulting with your organization's GIS staff member before proceeding. If you are not sure how to proceed with creating a new shapefile, please contact us.

  • Updating the boundary for an entire agency changes where residents can submit requests and may affect request routing. Review and test the resulting boundaries before relying on them in production.

Before You Begin

Prepare the file with your GIS staff first. Your shapefile must:

  • Be a single ZIP archive containing one shapefile bundle, with at least the .SHP and .SHX files. Include the .PRJ file too unless you select Process as EPSG 4326 projection (WGS84) during upload.

  • Use WGS84 (EPSG:4326) coordinates and plain Polygon geometry, with no Z or M values and no invalid or self-intersecting polygons.

  • Contain no more than 30 features.

  • Be simplified to the lowest level of detail you need, well below approximately 150,000 vertices per geography.

Polyline files, such as street centerlines, do not create separate boundaries. They produce a single fixed-width road corridor. For full details, see Requirements for Shapefile Boundaries.


Upload a Shapefile

  1. Sign in to your site

  2. Navigate to the Profile menu and select Manage Organization:User Profile menu, Manage Organization option.

  3. Select Geographies in the left-hand navigation:

  4. Click Upload a Shapefile:Upload a Shapefile button.

  5. Click Choose File and select the ZIP file containing your Shapefile The Geographies screen in the Shapefile Uploader section with the Choose File button highlighted.

  6. Fill in the remaining fields The Shapefile Uploader screen with various fields and checkboxes highlighted.

    • Title Attribute: Enter the attribute you would like to use to name the geography (usually auto). The title of the geography can be changed after the file is uploaded.

      Note:

      You'll need to enter a valid attribute from the attributes listed in the .DBF file. This attribute will then be used to initialize the geography's title. Entering "auto" generates a formatted title from the current timestamp and an incremented feature number, for example 2026-08-26T10:30:00-04:00 Feature 001. If your shapefile has no DBF file, enter "auto".

    • Allow more than 10 features: Check to expand the number of features.

    • Process as EPSG 4326 projection (WGS84). This forces the use of EPSG 4326 irrespective of the projection specified in the PRJ file.

      Note:

      Select this option only when the underlying shapefile data uses EPSG:4326 but the PRJ file is missing or the projection is not recognized. It does not transform data from another coordinate system. If the underlying coordinates do not use EPSG:4326, the resulting geographies will appear in the wrong location, and no error is shown.

  7. Click Save:The Shapefile Uploader screen with the Save button highlighted.

Uploaded geographies are created disabled. Enable each geography you want to use before relying on it. A disabled geography is not selectable in reports, on maps, or on request lists. For more information, see Geographies Overview.

Check the count. Features with no geometry are skipped, and polygons that cannot be saved, such as exact duplicates, are not imported. Compare the number of geographies created with the number of features in your file.

Processing time varies based on the size and complexity of the shapefile. Confirm that the expected geographies have been created before retrying the upload.


Validate the Resulting Geographies

  1. Confirm that the expected number of geographies was created, and that each one you plan to use is enabled.

  2. Display each geography on the map and confirm that its boundary appears in the correct location.

  3. Test locations that should be inside and outside the boundary, especially near borders and narrow areas.

  4. Confirm that request routing, assignments, and reports behave as intended, and that maps stay responsive.


Having Trouble?

If the upload is rejected, fails partway, runs slowly, or the result looks wrong, see Requirements for Shapefile Boundaries for troubleshooting. You can also contact CivicPlus Support and include the shapefile ZIP archive, your organization name, the approximate time of the upload, and any error message you received.