# Uploading Files

You can upload files to JMap Cloud for later use in creating data sources. The **Uploaded Files** tab, located in the **Data Sources** section, allows you to manage all uploaded files.

When you need to upload many files, such as to create a mosaic, you can do so in bulk from this interface.

The data contained in these files is stored in JMap Cloud databases. However, all files listed in the Uploaded Files tab are automatically deleted after **10 days**.

## Supported File Formats

Several file formats are accepted:

* **Vector data** (compressed `.zip` file): GeoJSON, SHP, File GeoDatabase, GML, TAB, CSV, DWG, GeoPackage
* **Raster data** (uncompressed file): GeoTIFF, ECW, JPEG2000
* **Tabular data** (compressed `.zip` file): CSV

You can select one or more files using the checkboxes, which will activate the **Delete** function. This allows you to delete multiple files in a single operation.

## Uploading a New File

For vector spatial data, which often comprises multiple files (for example, the SHP format with secondary files SHX, SPP, etc.), you must group them into a single `.zip` archive. The same applies to non-spatial tabular data files, which must also be compressed (`.zip`). Compression is not required for raster files.

**Upload methods**

* **Drag and drop** one or more files directly into the table. The upload starts automatically.
* Or click the **Upload File** button to open the file browser. Select your files, and the upload will start automatically.

{% hint style="info" %}
You can select an unlimited number of files to upload; a **maximum of three files can be uploaded simultaneously**. Other files will be queued and uploaded in turn.
{% endhint %}

Once the upload is started, the files appear in the table with a progress bar.

{% hint style="info" %}
Only the person who uploaded a file can see it in the Portal.
{% endhint %}

## File Status

The status of each file indicates the stage of the process that has been completed by JMap Cloud.

<table data-header-hidden><thead><tr><th width="179.54296875">Status</th><th>Description</th></tr></thead><tbody><tr><td>Waiting</td><td>Waiting to be uploaded.</td></tr><tr><td>Uploading</td><td>The file is being uploaded. <br>A progress bar in the Status column indicates the upload progress. A circle in the header bar indicates the upload progress and the number of files currently being uploaded. A message confirms whether the upload was successful or if there was a failure.</td></tr><tr><td>Uploaded</td><td>The file has been uploaded. It must be analyzed before it can be used to create a data source.</td></tr><tr><td>Analyzing</td><td>The file is being analyzed by JMap Cloud, which identifies properties such as file type, CRS, attributes, etc.</td></tr><tr><td>Analyzed</td><td>File is ready for use.</td></tr><tr><td>Error</td><td>There is an error in the file loading process.</td></tr></tbody></table>

## Managing a File

As with other JMap Cloud resources, you can access the available actions for a file by clicking the icon to the right of its row in the table. The available actions vary depending on the file's status:

* Create a data source
* Delete
* Cancel upload
* Display Information

### **Creating a Data Source from a File**

When the file status is **Analyzed**, the **Create a data source** option becomes available. Click this option to launch the data source creation interface.

Enter the required information based on the data type. For more details, see the [Vector/Raster Spatial Data Files](/en/jmap-cloud-portal/user-guide-for-jmap-cloud-portal/integrating-data-data-sources/creating-data-sources/vector-raster-data-files.md) and [Non-Spatial Tabular Data Files](/en/jmap-cloud-portal/user-guide-for-jmap-cloud-portal/integrating-data-data-sources/creating-data-sources/non-spatial-tabular-data-files.md) sections.

Click **Create** to generate the data source, which will then be added to the **Data Sources** tab table.

### **Canceling an Upload**

This option is available while the file is uploading or being analyzed. It allows you to stop the current process.

### **Displaying File Information**

Click **Display Information** to view:

* The file name
* Its size, format, and status
* The identifier of the user who performed the upload
* The upload date and time
* Metadata, including:
  * The unique identifier of the file, organization, and task
  * Layer names
  * The list of attributes and their types
  * The number of elements or records

### **Deleting a File**

Click **Delete**. A dialog box will ask you to confirm your choice.

{% hint style="info" %}
Deleting the file does not delete the data source that may have been created from it. Only the file is removed from the table.
{% endhint %}


---

# 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.jmapcloud.io/en/jmap-cloud-portal/user-guide-for-jmap-cloud-portal/integrating-data-data-sources/creating-data-sources/uploading-files.md?ask=<question>
```

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.