# Uploading Spatial Data SeaSketch supports uploading data in both vector and raster formats. From these files it creates high-performance vector or raster tiles which are served to end-users via a content delivery network (CDN). Layers hosted on SeaSketch are *fast*, and support our [advanced cartography tools](/seasketch-documentation/administrators-guide/overlay-layers/cartographic-styling.md) and [layer versioning features](#uploading-new-versions-of-a-dataset). We recommend hosting data directly from SeaSketch for the best user experience and offer 10 gigabytes of layer hosting for free with each project. ### Uploading a layer To create a new layer in SeaSketch, navigate to Admin > Data Layers > Overlay Layers and simply drag & drop a [supported file](#supported-data-types) to the window. Drag & drop as many files as you like, even all at once! Data files are processed individually on our cloud infrastructure, and can scale to handle as many as needed. You can also choose to browse for files on your computer using the Edit menu.
From the Overlay Layers toolbar, choose Edit > Add Data > Upload spatial data files

From the Overlay Layers toolbar, choose Edit > Add Data > Upload spatial data files

After choosing one or more files to upload, you will see a Background Task list appear at the bottom of the overlays list. This enables you to track the stages of processing for each upload.
Screenshot of background job progress indicator

The Background Jobs list will appear when there are uploads being actively processed.

If there are any errors while processing your upload, they will be indicated in the Background Jobs list where you can click the info button for more detail.
### Supported data types SeaSketch supports a growing list of vector and raster data formats. Some of these files have special requirements that are important to understand for successful uploads. If a data format you use is not currently supported, please [contact support](mailto:support@seasketch.org). #### Vector Formats * [Esri Shapefile](https://desktop.arcgis.com/en/arcmap/latest/manage-data/shapefiles/what-is-a-shapefile.htm) * [GeoJSON](https://geojson.org/) * [Flatgeobuf](https://flatgeobuf.org/) #### Shapefile special considerations Shapefiles are very common among GIS users and one of our top recommendations for uploads. They are smaller that GeoJSON due to their binary nature, so are faster to upload. You can also include FGDC or ISO 19139 xml metadata in your upload to automatically populate metadata. Each layer you upload needs to be represented by a single file, but "Shapefiles" are [actually many different files](https://desktop.arcgis.com/en/arcmap/latest/manage-data/shapefiles/shapefile-file-extensions.htm), each representing different concerns like projection information (.prj), geometry (.shp) and column values (.dbf). For this reason, you will need to create a Zipfile archive which contains all these associated files into one archive. *Before uploading a shapefile, make sure:* * [ ] You are uploading a .zip file archive * [ ] The .zip file contains all related sidecar files (.shp, .dbf, .prj, .shx, etc) * [ ] All files share the same name, excepting the file extension * [ ] The .zip file only contains files related to a single layer, and they are not contained in any subfolder For an example of a .zip file which meets these criteria, download this [example of the Federated States of Micronesia EEZ](https://seasketchhelp.s3.amazonaws.com/FSM_12nm_Territorial_Sea.zip). #### Raster Formats SeaSketch supports raster uploads in the following formats: * [GeoTiff](https://www.ogc.org/publications/standard/geotiff) - Including both RGB imagery or single-band data values * [NetCDF](https://en.wikipedia.org/wiki/NetCDF) - First layer found will be used Currently SeaSketch only supports uploading files with a single data layer. While SeaSketch can recognize 3-band RGB imagery, when encountering other multi-band GeoTiff or multi-layer NetCDF files the system will pick the first band or layer it encounters. We hope to add support for multi-layer raster uploads and vector formats like *File geodatabase* in the future, but this is a current limitation. ### Managing new versions of a dataset SeaSketch is designed to serve as a long-term steward of your data. This includes handling situations where a dataset is replaced by a new version. SeaSketch can track versions of a dataset, recording who uploaded it, when, and why through user-contributed change-log messages. Once in the system, you can even rollback layers to a previous version. To view data source versioning information, navigate to the *Data Source* tab in the layer editor. Here you will see a list of each version, which you can click to see further details. To create a new version of a layer, drag & drop a new layer to the *Data Source* tab. You will be prompted to provide a change-log message so that future viewers can understand why the revision was made.
Screenshot of a layer revision being processed

After dropping a new layer revision into the Data Source tab, processing progress can be visualized

#### Rolling back changes SeaSketch tracks older visions of layers in the database. This means you can rollback to an older version if a mistake is made. Rolling back to an older version deletes all later versions of a data source, so confirmation is required.
By default, SeaSketch retains all older versions of a data source, which count against your [data hosting quota](#managing-the-data-hosting-quota). You can set your project to only retain older versions for a specified length of time (e.g. 6 months). To adjust these settings, navigate to the Overlay Layers toolbar and select **Settings > Archived Layer Retention**. ### Enabling data download SeaSketch retains the original uploaded file in its database. If desired, you can enable your end users to download this file, as well as transform it into their spatial data format of choice. End users can right-click on these layers and choose *Download Data* when enabled. #### Enabling data download for a single layer From the layer editor, toggle the Enable Data Download switch.
#### Toggling data download for all layers From the Overlay Layers toolbar, choose **Settings > Data Download** to set whether uploaded files are downloadable or private by default. You can also use the **Edit > Data Download** actions to change settings for all existing layers.

SeaSketch has controls for the default downloadability of your uploaded data, as well as bulk actions to change the download setting for current layers.

### Managing the data hosting quota SeaSketch provides 10 GB of free storage for each project, which should be more than enough for most. This limit is in place to prevent abuse or misuse of SeaSketch. Some datasets (particularly raster imagery) may consume a disproportionate amount of this capacity. If a project reaches the data hosting limit, spatial data layer uploads will be disabled until storage is freed up. To facilitate this process, the Overlay Layers toolbar can be used to show a summary of how layers are counting against the storage limit. Choose **View > Data Hosting Quota** to see this visualization.
Use this treemap visualization to identify which layers are consuming the most storage space. Deleting these layers will immediately free up space and enable you to upload layers again. If you project is unable to remain under the data hosting quota, please [contact support](mailto:support@seasketch.org) for assistance. ### AI Processing When uploading a layer, you may be prompted to enable or disable AI processing of your upload's metadata in order to automatically create useful layer titles and cartographic styles. See the [AI Cartographer section](/seasketch-documentation/administrators-guide/overlay-layers/ai-cartographer.md) for more details on these settings and features. --- # Agent Instructions: 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: ``` GET https://docs.seasketch.org/seasketch-documentation/administrators-guide/overlay-layers/uploading-spatial-data.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.