{"componentChunkName":"component---src-templates-markdown-template-jsx","path":"/guides/data-platform/setup/csv/import/","result":{"data":{"pageMetadata":{"title":"Import Data with CSV Files","path":"/guides/data-platform/setup/csv/import/","sourceCode":null,"metadataParent":{"title":"Import Data with CSV Files","path":"/guides/data-platform/setup/csv/","sourceCode":null,"hasVersionPicker":null,"metadataChildren":[{"title":"Import Data with CSV Files","path":"/guides/data-platform/setup/csv/import/","order":1,"label":null},{"title":"CSV File Reference","path":"/guides/data-platform/setup/csv/reference/","order":2,"label":null},{"title":"SFTP Credentials","path":"/guides/data-platform/setup/csv/sftp-credentials/","order":3,"label":null}],"metadataParent":{"title":"Setup","path":"/guides/data-platform/setup/","metadataChildren":[{"title":"Connections","path":"/guides/data-platform/setup/connections/","order":1,"label":null},{"title":"Feeds","path":"/guides/data-platform/setup/feeds/","order":5,"label":null},{"title":"Import Data with CSV Files","path":"/guides/data-platform/setup/csv/","order":6,"label":null}],"metadataParent":{"title":"Data Platform","path":"/guides/data-platform/","metadataChildren":[{"title":"Trends","path":"/guides/data-platform/trends/","order":1,"label":null},{"title":"Setup","path":"/guides/data-platform/setup/","order":2,"label":null},{"title":"Live Stream","path":"/guides/data-platform/live-stream/","order":3,"label":null},{"title":"Data Catalog","path":"/guides/data-platform/catalog/","order":4,"label":null},{"title":"Rules","path":"/guides/data-platform/rules/","order":5,"label":null},{"title":"Plans","path":"/guides/data-platform/data-planning/","order":6,"label":null},{"title":"Filters","path":"/guides/data-platform/data-filter/","order":7,"label":null},{"title":"Event Forwarding","path":"/guides/data-platform/event-forwarding/","order":8,"label":null},{"title":"Event Match Quality","path":"/guides/data-platform/event-match-quality/","order":9,"label":null},{"title":"Data Retention","path":"/guides/data-platform/data-retention/","order":10,"label":null},{"title":"Tiered Events","path":"/guides/data-platform/tiered-events/","order":11,"label":null},{"title":"Blocked Data Backfill Guide","path":"/guides/data-platform/blocked-data-backfill-guide/","order":12,"label":null}],"metadataParent":{"title":"Guides","path":"/guides/","metadataChildren":[{"title":"Platform Overview","path":"/guides/platform-overview/","order":0.5,"label":null},{"title":"Getting Started","path":"/guides/getting-started/","order":1,"label":null},{"title":"mParticle Agent","path":"/guides/mparticle-agent/","order":1.5,"label":null},{"title":"Oversight","path":"/guides/oversight/","order":2,"label":null},{"title":"Data Platform","path":"/guides/data-platform/","order":3,"label":null},{"title":"Data Warehouse","path":"/guides/data-warehouse/","order":4,"label":null},{"title":"Customer 360","path":"/guides/customer-360/","order":5,"label":null},{"title":"Analytics","path":"/guides/analytics/","order":6,"label":null},{"title":"Audiences","path":"/guides/audiences/","order":7,"label":null},{"title":"Settings","path":"/guides/settings/","order":8,"label":null},{"title":"Troubleshooting mParticle","path":"/guides/troubleshooting/","order":10,"label":null},{"title":"Default Service Limits","path":"/guides/default-service-limits/","order":11,"label":null},{"title":"Glossary","path":"/guides/glossary/","order":12,"label":null}],"metadataParent":null}}}}},"markdownRemark":{"html":"

You can import bulk data, both user attribute and events, from your data warehouse or legacy system using comma separated values (CSV) files. You can use this technique in all regions and with all outputs.

\n

Use the following process to load user attribute or event data from CSV files:

\n\n

\n \n \n \n \n \n \n \n 1. Create CSV files

\n

Prepare the CSV files for import. Files must follow the guidelines in this section.

\n

\n \n \n \n \n \n \n \n File guidelines

\n\n

\n \n \n \n \n \n \n \n Data guidelines

\n\n

\n \n \n \n \n \n \n \n 2. Get credentials for the mParticle SFTP server

\n

mParticle maintains an SFTP server where you drop your CSV files. Your SFTP username and password are self-provisioned from the mParticle dashboard.

\n

See SFTP Credentials for step-by-step instructions, including how to reset your password.

\n

\n \n \n \n \n \n \n \n 3. Configure the Custom CSV Feed

\n

Configure the Custom CSV Feed as input. This step provides the hostname and folder path on the SFTP server where your CSV files must be dropped.

\n\n

To configure the Custom CSV Feed:

\n
    \n
  1. Go to Data Platform > Setup > Inputs using the left hand nav and select the Feeds tab.
    2. \n
  2. \n

    Using the Add Feed Input + dropdown menu, search for and select Custom CSV Feed.

    \n\n
    3. \n
  3. \n

    Enter the following values:

    \n\n
    4. \n
  4. \n

    After you complete the connection configuration, click Issue SFTP Details. mParticle displays your hostname and path for mParticle’s SFTP server.

    \n

    \"screenshot

    \n
    5. \n
\n

\n \n \n \n \n \n \n \n 4. Drop CSV files on the SFTP server

\n
    \n
  1. Connect to the mParticle SFTP server using the credentials provided. Once you have connected, the mParticle creates the drop folder. If you don’t see one, create a folder named drop.
    2. \n
  2. Create a new folder inside the drop folder, and name it using the pathname provided in the mParticle UI as shown in the previous section. For example, based on the previous example, the folder path and name is sftp.mparticle.com:4422:drop/us1-123456789123456789/. Hint: Verify that there are no trailing spaces in the name.
    3. \n
  3. Use your credentials to upload your CSV files to mParticle’s SFTP server, using the correct path and folder name from the previous step.
    4. \n
\n

Files on the SFTP location are added to the processing queue nearly immediately. Depending on file count and file size, a backlog may develop. You can observe how much data has been processed using Data Master and your outbound connections. There is no notification of processing progress or completion.

\n","frontmatter":{"title":"Import Data with CSV Files","order":1,"seoTitle":null,"seoDescription":null},"parent":{"__typename":"File","modifiedTime":"October 12, 2026"}}},"pageContext":{"slug":"/guides/data-platform/setup/csv/import/"}},"staticQueryHashes":["2950460867"]}