# Importing Submissions

## Importing Submission Data

Whether you're migrating data between projects or importing data from an external database, the **Import CSV** button allows you to select a CSV file containing data from your local machine and import that data into the given Form or Resource. 

{% hint style="warning" %}
When importing submissions through a CSV, each imported submission may trigger any configured [actions](https://help.form.io/userguide/forms/form-building/actions) as if that submission derived from a form user. When importing a significant number of submissions, consider temporarily disabling actions such as email notifications.
{% endhint %}

### **Configuring CSV Files**

In order to import data, a properly configured CSV File is required for the import to succeed. The CSV column headers need to map directly to the fields on the form you wish to import data to. Ensure that your column headers match the **Property Name** of your fields before importing the file. 

Use the CSV rows to add different submission entries within the file. 

<figure><img src="https://3305536326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPHoF2HwOA0s5HV_AIB%2Fuploads%2F1JdI9IeV9luc8zyn6bRr%2Fimportdata2.jpg?alt=media&#x26;token=9f5e600c-bfe4-4438-aff0-af0a112c2006" alt=""><figcaption></figcaption></figure>

### Importing File

When your CSV file is ready, click the **Import CSV** button within the data tab and select the file.&#x20;

<figure><img src="https://3305536326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPHoF2HwOA0s5HV_AIB%2Fuploads%2F9YzLBSn0fPxcoyC8zCL2%2Fimportdata3.jpg?alt=media&#x26;token=1f0364c4-a2f9-40b5-b03f-aa409979b223" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Selecting the **Replace all submissions** setting will replace all existing submission entries with the row data inside the CSV file&#x20;
{% endhint %}

Once the import is complete, the Submission View table will reflect the CSV file entries.

<figure><img src="https://3305536326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPHoF2HwOA0s5HV_AIB%2Fuploads%2FjM1BDNV5XPe3gqB3nWfX%2Fimportdata4.jpg?alt=media&#x26;token=5fdd787d-1f72-42ca-8358-b0c3c53f7b7c" alt=""><figcaption></figcaption></figure>


---

# 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://help.form.io/userguide/submissions/importing-submissions.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.